Что такое код hw_insertobject

Содержание

Что такое код hw_insertobject

(PHP 3>= 3.0.3, PHP 4)

hw_InsertObject — вставляет запись объекта/object record.

Описание

int hw_insertobject (int connection, string object rec, string parameter)

Вставляет объект в сервер. Это может быть любой правильный hyperwave-объект. См. в документации по HG-CSP детальную информацию о необходимых параметрах.

Примечание: если вы хотите вставить Anchor/якорь, атрибут Position всегда будет установлен со значением start/end или ‘invisible’. Invisible/невидимые позиции необходимы, когда аннотация не имеет соответствующей ссылки в тексте аннотации.


Назад Оглавление Вперёд
hw_InsertDocument Вверх hw_mapid

Если Вы не нашли что искали, то рекомендую воспользоваться поиском по сайту:

hw_InsertObject

hw_InsertObject — Inserts an object record

Описание

Inserts an object into the server.

Note: If you want to insert an Anchor, the attribute Position has always been set either to a start/end value or to ‘invisible’. Invisible positions are needed if the annotation has no corresponding link in the annotation text.

Список параметров

The connection identifier.

The object can be any valid hyperwave object.

See the HG-CSP documentation for a detailed information on how the parameters have to be.

Что такое код hw_insertobject

(PHP 3 >= 3.0.3, PHP 4, PECL)

hw_InsertObject — Inserts an object record

Description int hw_insertobject ( int connection, string object_rec, string parameter )

Inserts an object into the server. The object can be any valid hyperwave object. See the HG-CSP documentation for a detailed information on how the parameters have to be.

Note: If you want to insert an Anchor, the attribute Position has always been set either to a start/end value or to ‘invisible’. Invisible positions are needed if the annotation has no corresponding link in the annotation text.

Что такое код hw_insertobject

(PHP 3>= 3.0.3, PHP 4 )

hw_InsertObject — Inserts an object record

Description int hw_insertobject ( int connection, string object_rec, string parameter )

Inserts an object into the server. The object can be any valid hyperwave object. See the HG-CSP documentation for a detailed information on how the parameters have to be.

Note: If you want to insert an Anchor, the attribute Position has always been set either to a start/end value or to ‘invisible’. Invisible positions are needed if the annotation has no corresponding link in the annotation text.

Что такое код hw_insertobject

int hw_insertobject (int connection, string object rec, string parameter);

Inserts an object into the server. The object can be any valid hyperwave object. See the HG-CSP documentation for a detailed information on how the parameters have to be.

Note: If you want to insert an Anchor, the attribute Position has always been set either to a start/end value or to ‘invisible’. Invisible positions are needed if the annotation has no correspondig link in the annotation text.

hw_api::insertcollection — Inserts a new object of type collection

(PHP 4, PHP 5 hw_api::insertcollection — Inserts a new object of type collection

Описание

This function is a shortcut for hwapi_insert() . It inserts an object of type collection and sets some of the attributes required for a collection.

Список параметров

The parameter array contains the required elements ‘object’ and ‘parent >hwapi_insert() for the meaning of each element.

Что такое код hw_insertobject

int hw_insertobject (int connection, string object rec, string parameter);

Inserts an object into the server. The object can be any valid hyperwave object. See the HG-CSP documentation for a detailed information on how the parameters have to be.

Note: If you want to insert an Anchor, the attribute Position has always been set either to a start/end value or to ‘invisible’. Invisible positions are needed if the annotation has no correspondig link in the annotation text.

Что такое код hw_insertobject

(PHP 3>= 3.0.3, PHP 4)

hw_InsertObject — вставляет запись объекта/object record.

Описание

int hw_insertobject (int connection, string object rec, string parameter)

Вставляет объект в сервер. Это может быть любой правильный hyperwave-объект. См. в документации по HG-CSP детальную информацию о необходимых параметрах.

Примечание: если вы хотите вставить Anchor/якорь, атрибут Position всегда будет установлен со значением start/end или ‘invisible’. Invisible/невидимые позиции необходимы, когда аннотация не имеет соответствующей ссылки в тексте аннотации.

hw_InsertObject

hw_InsertObject — Inserts an object record

Description

Inserts an object into the server.

Note: If you want to insert an Anchor, the attribute Position has always been set either to a start/end value or to ‘invisible’. Invisible positions are needed if the annotation has no corresponding link in the annotation text.

Parameters

The connection identifier.

The object can be any valid hyperwave object.

See the HG-CSP documentation for a detailed information on how the parameters have to be.

Создание объектов .NET и COM (New-Object) Creating .NET and COM Objects (New-Object)

Существуют программные компоненты с интерфейсами платформы .NET Framework и COM, которые позволяют выполнять множество задач системного администрирования. There are software components with .NET Framework and COM interfaces that enable you to perform many system administration tasks. Windows PowerShell позволяет использовать эти компоненты, поэтому доступные задачи не ограничиваются только применением командлетов. Windows PowerShell lets you use these components, so you are not limited to the tasks that can be performed by using cmdlets. Множество командлетов в первом выпуске Windows PowerShell не работают с удаленными компьютерами. Many of the cmdlets in the initial release of Windows PowerShell do not work against remote computers. Мы покажем, как преодолеть это ограничение при управлении журналами событий с помощью класса System.Diagnostics.EventLog .NET Framework непосредственно из Windows PowerShell. We will demonstrate how to get around this limitation when managing event logs by using the .NET Framework System.Diagnostics.EventLog class directly from Windows PowerShell.

Использование командлета New-Object для доступа к журналу событий Using New-Object for Event Log Access

Библиотека классов платформы .NET Framework включает класс System.Diagnostics.EventLog, позволяющий управлять журналами событий. The .NET Framework Class Library includes a class named System.Diagnostics.EventLog that can be used to manage event logs. Можно создать новый экземпляр класса .NET Framework с помощью командлета New-Object с параметром TypeName. You can create a new instance of a .NET Framework class by using the New-Object cmdlet with the TypeName parameter. Например, следующая команда создает ссылку на журнал событий: For example, the following command creates an event log reference:

Хотя команда и создала экземпляр класса EventLog, этот экземпляр не содержит данных. Although the command has created an instance of the EventLog class, the instance does not include any data. Это вызвано тем, что не был указан определенный журнал событий. That is because we did not specify a particular event log. Как получить настоящий журнал событий? How do you get a real event log?

Использование конструкторов с командлетом New-Object Using Constructors with New-Object

Чтобы сослаться на определенный журнал событий, нужно указать его имя. To refer to a specific event log, you need to specify the name of the log. Командлет New-Object имеет параметр ArgumentList. New-Object has an ArgumentList parameter. Аргументы, передаваемые в этот параметр, используются специальным методом запуска объекта. The arguments you pass as values to this parameter are used by a special startup method of the object. Этот метод называется конструктором, поскольку используется для создания объекта. The method is called a constructor because it is used to construct the object. Например, чтобы получить ссылку на журнал приложений, нужно указать строку «Application» в качестве аргумента: For example, to get a reference to the Application log, you specify the string ‘Application’ as an argument:

Поскольку основные классы платформы .NET Framework содержатся в пространстве имен System, Windows PowerShell автоматически пытается найти в нем указанные классы, если не может найти совпадения для указанного имени типа. Since most of the .NET Framework core classes are contained in the System namespace, Windows PowerShell will automatically attempt to find classes you specify in the System namespace if it cannot find a match for the typename you specify. Это значит, что можно указать класс Diagnostics.EventLog вместо класса System.Diagnostics.EventLog. This means that you can specify Diagnostics.EventLog instead of System.Diagnostics.EventLog.

Сохранение объектов в переменных Storing Objects in Variables

Вам может понадобиться сохранить ссылку на объект для использования в текущей оболочке. You might want to store a reference to an object, so you can use it in the current shell. Хотя Windows PowerShell позволяет выполнять больше задач с помощью конвейеров, что снижает потребность в переменных, иногда сохранение ссылок на объекты в переменных помогает сделать работу с объектами более удобной. Although Windows PowerShell lets you do a lot of work with pipelines, lessening the need for variables, sometimes storing references to objects in variables makes it more convenient to manipulate those objects.

Windows PowerShell позволяет создавать переменные, которые, по сути, являются именованными объектами. Windows PowerShell lets you create variables that are essentially named objects. Выходные данные любой допустимой команды Windows PowerShell можно сохранить в переменной. The output from any valid Windows PowerShell command can be stored in a variable. Имена переменных всегда начинаются со знака «$». Variable names always begin with $. Если нужно сохранить ссылку на журнал приложений в переменной с именем $AppLog, введите имя переменной, знак равенства и команду, используемую для создания объекта журнала приложений: If you want to store the Application log reference in a variable named $AppLog, type the name of the variable, followed by an equal sign and then type the command used to create the Application log object:

Если после этого набрать $AppLog, будет выведено содержимое журнала приложения: If you then type $AppLog, you can see that it contains the Application log:

Доступ к удаленному журналу событий с помощью New-Object Accessing a Remote Event Log with New-Object

Команды, рассмотренные в предыдущем разделе, обращаются к локальному компьютеру. Для этого подходит и командлет Get-EventLog. The commands used in the preceding section target the local computer; the Get-EventLog cmdlet can do that. Чтобы получить доступ к журналу приложений на удаленном компьютере, необходимо в качестве аргументов ввести имя журнала и имя (или IP-адрес) компьютера. To access the Application log on a remote computer, you must supply both the log name and a computer name (or IP address) as arguments.

Какие действия могут быть выполнены с переменной $RemoteAppLog после сохранения в ней ссылки на журнал событий? Now that we have a reference to an event log stored in the $RemoteAppLog variable, what tasks can we perform on it?

Очистка журнала событий методами объектов Clearing an Event Log with Object Methods

Для выполнения тех или иных действий у объектов часто имеются методы. Objects often have methods that can be called to perform tasks. Командлет Get-Member позволяет вывести методы, связанные с объектом. You can use Get-Member to display the methods associated with an object. Следующая команда и выделенный фрагмент выходных данных показывают некоторые методы класса EventLog: The following command and selected output show some the methods of the EventLog class:

Метод Clear() позволяет очистить журнал событий. The Clear() method can be used to clear the event log. При вызове метода после его имени обязательно должны следовать скобки, даже если методу не требуются аргументы. When calling a method, you must always follow the method name by parentheses, even if the method does not require arguments. Таким образом оболочка Windows PowerShell отличает метод от возможного свойства с таким же именем. This lets Windows PowerShell distinguish between the method and a potential property with the same name. Чтобы вызвать метод Clear, нужно ввести следующую команду: Type the following to call the Clear method:

Введите следующую строку, чтобы отобразить журнал: Type the following to display the log. Видно, что журнал событий очищен, и вместо 262 записей не содержит ни одной. You will see that the event log was cleared, and now has 0 entries instead of 262:

Создание COM-объектов с помощью New-Object Creating COM Objects with New-Object

Командлет New-Object может использоваться для работы с СОМ-компонентами. You can use New-Object to work with Component Object Model (COM) components. Спектр этих компонентов довольно обширен — от различных библиотек, поставляемых с сервером сценариев Windows (WSH), до приложений ActiveX, например Internet Explorer, установленных на большинстве систем. Components range from the various libraries included with Windows Script Host (WSH) to ActiveX applications such as Internet Explorer that are installed on most systems.

Командлет New-Object создает СОМ-объекты с помощью вызываемых оболочек времени выполнения .NET Framework, поэтому для него действуют те же ограничения, что и для платформы .NET Framework во время вызова СОМ-объектов. New-Object uses .NET Framework Runtime-Callable Wrappers to create COM objects, so it has the same limitations that .NET Framework does when calling COM objects. Чтобы создать СОМ-объект, необходимо задать параметр ComObject для программного идентификатора ProgId нужного класса СОМ-объекта. To create a COM object, you need to specify the ComObject parameter with the Programmatic Identifier or ProgId of the COM class you want to use. Подробное обсуждение ограничений использования СОМ-объектов и определение доступных в системе программных идентификаторов выходит за рамки данного руководства пользователя, но с оболочкой Windows PowerShell может использоваться большинство хорошо известных объектов таких сред, как сервер сценариев Windows. A complete discussion of the limitations of COM use and determining what ProgIds are available on a system is beyond the scope of this user’s guide, but most well-known objects from environments such as WSH can be used within Windows PowerShell.

Объекты сервера сценариев Windows можно создать, указав следующие программные идентификаторы: WScript.Shell, WScript.Network, Scripting.Dictionary и Scripting.FileSystemObject. You can create the WSH objects by specifying these progids: WScript.Shell, WScript.Network, Scripting.Dictionary, and Scripting.FileSystemObject. Эти объекты создаются следующими командами: The following commands create these objects:

Хотя функциональность этих классов в большой степени может быть реализована другими способами в Windows PowerShell, некоторые действия (например создание ярлыков) проще выполнить с помощью классов сервера сценариев Windows. Although most of the functionality of these classes is made available in other ways in Windows PowerShell, a few tasks such as shortcut creation are still easier to do using the WSH classes.

Создание ярлыков на рабочем столе с помощью WScript.Shell Creating a Desktop Shortcut with WScript.Shell

Одной из функций, быстро выполняемых с помощью СОМ-объектов, является создание ярлыков. One task that can be performed quickly with a COM object is creating a shortcut. Допустим, на рабочем столе требуется создать ярлык для корневой папки Windows PowerShell. Suppose you want to create a shortcut on your desktop that links to the home folder for Windows PowerShell. Сначала необходимо создать ссылку на объект WScript.Shell, которая сохраняется в переменной $WshShell: You first need to create a reference to WScript.Shell, which we will store in a variable named $WshShell:

Командлет Get-Member работает и с СОМ-объектами, поэтому элементы объекта можно изучить, введя следующее: Get-Member works with COM objects, so you can explore the members of the object by typing:

У командлета Get-Member есть необязательный параметр InputObject, который можно использовать вместо передачи по конвейеру, чтобы предоставить входные данные для Get-Member. Get-Member has an optional InputObject parameter you can use instead of piping to provide input to Get-Member. При использовании команды Get-Member -InputObject $WshShell в примере выше выходные данные были бы такими же. You would get the same output as shown above if you instead used the command Get-Member -InputObject $WshShell. При указании параметра InputObject командлет обрабатывает свои аргументы как одно целое. If you use InputObject, it treats its argument as a single item. Это означает, что если в переменной содержится несколько объектов, командлет Get-Member обрабатывает их как массив объектов. This means that if you have several objects in a variable, Get-Member treats them as an array of objects. Например: For example:

Метод WScript.Shell CreateShortcut допускает использование одного аргумента — пути к создаваемому файлу ярлыка. The WScript.Shell CreateShortcut method accepts a single argument, the path to the shortcut file to create. Можно указать полный путь к рабочему столу, но существует и более простой способ. We could type in the full path to the desktop, but there is an easier way. Рабочий стол обычно представлен папкой с именем Desktop внутри домашней папки текущего пользователя. The desktop is normally represented by a folder named Desktop inside the home folder of the current user. В Windows PowerShell имеется переменная $Home, в которой содержится путь к этой домашней папке. Windows PowerShell has a variable $Home that contains the path to this folder. Таким образом, путь к домашней папке может быть задан указанием этой переменной, после чего нужно ввести только имя папки Desktop и имя создаваемого ярлыка: We can specify the path to the home folder by using this variable, and then add the name of the Desktop folder and the name for the shortcut to create by typing:

Если похожая на переменную строка заключена в двойные кавычки, Windows PowerShell пытается заменить ее подходящим значением. When you use something that looks like a variable name inside double-quotes, Windows PowerShell tries to substitute a matching value. При использовании одиночных кавычек значение переменной не подставляется. If you use single-quotes, Windows PowerShell does not try to substitute the variable value. Например, попробуйте ввести следующие команды: For example, try typing the following commands:

В переменной $lnk теперь хранится новая ссылка на ярлык. We now have a variable named $lnk that contains a new shortcut reference. Чтобы просмотреть элементы переменной, ее можно передать по конвейеру в Get-Member. If you want to see its members, you can pipe it to Get-Member. Выходные данные (см. ниже) показывают все элементы, необходимые, чтобы завершить создание ярлыка: The output below shows the members we need to use to finish creating our shortcut:

Осталось определить свойство TargetPath, указывающее путь к папке Windows PowerShell, и вызвать метод Save, чтобы сохранить $lnk ярлыка. We need to specify the TargetPath, which is the application folder for Windows PowerShell, and then save the shortcut $lnk by calling the Save method. Путь к папке Windows PowerShell хранится в переменной $PSHome, поэтому это можно сделать, введя следующее: The Windows PowerShell application folder path is stored in the variable $PSHome, so we can do this by typing:

Использование Internet Explorer из Windows PowerShell Using Internet Explorer from Windows PowerShell

С помощью СОМ-объектов можно автоматизировать многие приложения (включая семейство приложений Microsoft Office и Internet Explorer). Many applications (including the Microsoft Office family of applications and Internet Explorer) can be automated by using COM. На примере Internet Explorer можно рассмотреть некоторые типичные приемы и тонкости, связанные с работой приложений, основанных на СОМ-технологии. Internet Explorer illustrates some of the typical techniques and issues involved in working with COM-based applications.

Экземпляр Internet Explorer создается указанием программного идентификатора этого приложения InternetExplorer.Application: You create an Internet Explorer instance by specifying the Internet Explorer ProgId, InternetExplorer.Application:

Эта команда запускает Internet Explorer, но не отображает его. This command starts Internet Explorer, but does not make it visible. Если запустить командлет Get-Process, то можно увидеть выполняющийся процесс iexplore. If you type Get-Process, you can see that a process named iexplore is running. Причем после выхода из Windows PowerShell выполнение этого процесса будет продолжаться. In fact, if you exit Windows PowerShell, the process will continue to run. Чтобы завершить процесс iexplore, необходимо перезагрузить компьютер или воспользоваться средством наподобие диспетчера задач. You must reboot the computer or use a tool like Task Manager to end the iexplore process.

СОМ-объекты, запускаемые в виде отдельных процессов, обычно называются исполняемыми файлами ActiveX. При их запуске окно пользовательского интерфейса отображается не всегда. COM objects that start as separate processes, commonly called ActiveX executables, may or may not display a user interface window when they start up. Если окно создается, но не отображается, как в случае с приложением Internet Explorer, фокус обычно перемещается на рабочий стол Windows, и для взаимодействия с окном его необходимо сделать видимым. If they create a window but do not make it visible, like Internet Explorer, the focus will generally move to the Windows desktop and you must make the window visible to interact with it.

Введя $ie | Get-Member, можно получить список свойств и методов для Internet Explorer. By typing $ie | Get-Member, you can view properties and methods for Internet Explorer. Чтобы отобразить окно Internet Explorer, свойству Visible нужно присвоить значение $true, введя следующее: To see the Internet Explorer window, set the Visible property to $true by typing:

После этого можно перейти по какому-либо веб-адресу, используя метод Navigate: You can then navigate to a specific Web address by using the Navigate method:

Другие элементы объектной модели Internet Explorer позволяют получить текстовое содержание веб-страниц. Using other members of the Internet Explorer object model, it is possible to retrieve text content from the Web page. Следующая команда отображает HTML-текст в теле текущей веб-страницы: The following command will display the HTML text in the body of the current Web page:

Чтобы закрыть Internet Explorer из PowerShell, необходимо вызвать метод Quit(): To close Internet Explorer from within PowerShell, call its Quit() method:

Это приведет к принудительному закрытию приложения. This will force it to close. Переменная $ie больше не содержит действительную ссылку, хотя все еще отображается как СОМ-объект. The $ie variable no longer contains a valid reference even though it still appears to be a COM object. Попытка использования этой переменной приводит к ошибке автоматизации: If you attempt to use it, you will get an automation error:

В этой ситуации можно либо удалить оставшуюся ссылку с помощью команды $ie = $null, либо полностью удалить переменную: You can either remove the remaining reference with a command like $ie = $null, or completely remove the variable by typing:

Для исполняемых файлов ActiveX нет общего стандарта, по которому выполнение их процессов завершается или продолжается после удаления ссылки на них. There is no common standard for whether ActiveX executables exit or continue to run when you remove a reference to one. Выход из приложения зависит от обстоятельств (видимо ли приложение, открыт ли в нем какой-либо отредактированный документ, а также продолжается ли выполнение Windows PowerShell). Depending on circumstances such as whether the application is visible, whether an edited document is running in it, and even whether Windows PowerShell is still running, the application may or may not exit. Поэтому требуется проверка поведения при завершении работы каждого исполняемого файла ActiveX, используемого в Windows PowerShell. For this reason, you should test termination behavior for each ActiveX executable you want to use in Windows PowerShell.

Получение предупреждений о вызываемых COM-объектах .NET Framework Getting Warnings About .NET Framework-Wrapped COM Objects

В некоторых случаях у СОМ-объекта есть соответствующая вызываемая оболочка времени выполнения (RCW) .NET Framework, и именно она используется командлетом New-Object. In some cases, a COM object might have an associated .NET Framework Runtime-Callable Wrapper or RCW, and this will be used by New-Object. Поведение оболочки RCW может отличаться от поведения обычного СОМ-объекта, поэтому у командлета New-Object есть параметр Strict, используемый для предупреждения о доступе к RCW. Since the behavior of the RCW may be different from the behavior of the normal COM object, New-Object has a Strict parameter to warn you about RCW access. Если указать параметр Strict и создать СОМ-объект, использующий оболочку RCW, выводится предупреждение: If you specify the Strict parameter and then create a COM object that uses an RCW, you get a warning message:

Объект создается, но предупреждение указывает на то, что он не является стандартным СОМ-объектом. Although the object is still created, you are warned that it is not a standard COM object.

Илон Маск рекомендует:  Что такое код lseek
Понравилась статья? Поделиться с друзьями:
Кодинг, CSS и SQL