Создает экземпляр зарегистрированного объекта COM (такого, как Visual FoxPro Automation server) на удаленном компьютере.


CREATEOBJECTEX(cCLSID \| cPROGID, cComputerName [, cIID])

Параметры

cCLSID| cPROGID

Указывает CLSID (Идентификатор класса) или PROGID (Программный идентификатор) для создания экземпляра COM объекта. Если вы включите в вызов функции CLSID, объект COM должен быть зарегистрирован на удаленном сервере, который вы укажите в параметр cComputerName. Если вы включите в вызов функции PROGID, объект COM должен быть зарегистрирован на обоих компьютерах, как на локальном, так и на удаленном, который вы укажите в параметре cComputerName. Попытка использовать PROGID без первичной регистрации сервера на вашем локальном компьютере приведен к генерации ошибки OLE с текстом Code 0x800401f3, "Invalid Class String."

Для серверов автоматизации Visual FoxPro, созданных на вашей локальной машине, вы можете использовать свойства объекта сервера CLSID и PROGID, для определения локальных значений CLSID и PROGID.

cComputerName

Указывает удаленный компьютер, на котором создается объект COM.

Если cComputerName представляет собой пустую строку, то COM объект создается на локальном компьютере или на перенаправленной машине, если это определено в реестре.

cComputerName поддерживает имена Universal Naming Convention (UNC) такие, как "\\myserver" и "myserver," и имена Domain System Names (DNS).

cIID: Указывает Interface ID GUID для cCLSID | cPROGID, когда вы создаете ранее связывание экземпляра класса. Если вы посылаете пустую строку в качестве cIID Visual FoxPro попытается обратиться к интерфейсу по умолчанию (IID) для cCLSID | cPROGID.

Возвращаемое значение

Пример

	Скопировать код
x = CREATEOBJECTEX("excel.application","",; "{000208D5-0000-0000-C000-000000000046}")

Замечание
Приведенное ниже представляет собой допустимый вызов функции для объект автоматизации "excel application". Вызов возвратит дефолтный интерфейс excel.application.

	Скопировать код
x = CREATEOBJECTEX("excel.application","","")

Примечания

CREATEOBJECTEX() возвращает объектную ссылку на объект COM, если он был успешно создан. CREATEOBJECTEX() не может быть использована для создания объектов классов Visual FoxPro таких, как формы – для их создания используйте функцию CREATEOBJECT(). Отметьте, что вы можете сократить имя в вызове CREATEOBJECTEX( ) минимум до 13 символов, чтобы различить между собой эту функцию и функцию CREATEOBJECT().

Когда вы вызываете определенные классы COM с помощью CREATEOBJECT() они возращают "No such interface supported", так они не поддерживают интерфейс IDispatch. С помощью использования параметра cIID вы можете теперь обращаться в таким классам в ваших приложениях.

Если вы пошлете в качестве cIID пустую строку (""), то Visual FoxPro попытается получить интерфейс по умолчанию (IID) для указанного CLSID или PROGID.

Поскольку он поддерживает ранее связывание через cIID, CREATEOBJECTEX() может помочь улучшить производительность путем исключения таких непроизводительных вызовов IDispatch.

CREATEOBJECTEX() поддерживает создание новых объектов раннего связывания. Однако, это также возможно, что ваш компонент Visual FoxPro посылаетися объекту, который вы вызываете через ранее ранее связывание. Вы можете использовать поддержку GETINTERFACE() на существующих объектах COM .

Для получения более подробной информации об использовании Visual FoxPro для создания серверов автоматизации (Automation servers) смотрите описание Совместное использование информации и введение OLE.

Параметры

Возвращаемое значение

Пример

Примечания

Смотрите также

Справочное руководство

Прочие ресурсы