Поделиться через

Метод IPrintCoreHelper::CreateInstanceOfMSXMLObject (prcomoem.h)

  • Статья

Метод IPrintCoreHelper::CreateInstanceOfMSXMLObject создает экземпляр объекта MSXML 6.0, используя правильную библиотеку DLL MSXML.

Синтаксис

HRESULT CreateInstanceOfMSXMLObject(
  [in]  IN REFCLSID  rclsid,
  [in]  IN LPUNKNOWN pUnkOuter,
  [in]  IN DWORD     dwClsContext,
  [in]  IN REFIID    riid,
  [out] OUT LPVOID   *ppv
);

Параметры

[in] rclsid

ИДЕНТИФИКАТОР CLSID, связанный с данными и кодом, которые будут использоваться для создания объекта .

[in] pUnkOuter

Указатель на интерфейс IUnknown объекта агрегата (управляющий IUnknown). Этот параметр должен иметь значение NULL, что означает, что объект не создается как часть статистического выражения.

[in] dwClsContext

Контекст, в котором будет выполняться код, который управляет вновь созданным объектом. Единственными допустимыми значениями являются NULL и CLSCTX_INPROC_SERVER, которые являются значением перечисления CLSCTX (описано в документации по Microsoft Windows SDK).

[in] riid

Ссылка на идентификатор интерфейса, который будет использоваться для взаимодействия с объектом .

[out] ppv

Указатель на переменную, получающую адрес интерфейса, запрашиваемого в параметре riid . Если IPrintCoreHelper::CreateInstanceOfMSXMLObject успешно возвращается, *ppv содержит адрес запрошенного интерфейса. Если этот метод завершается сбоем, *ppv содержит значение NULL.

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

IPrintCoreHelper::CreateInstanceOfMSXMLObject должен возвращать одно из следующих значений.

Код возврата Описание
S_OK
 Экземпляр указанного класса объектов успешно создан.
CLASS_E_NOAGGREGATION
 Указанный класс не может быть создан как часть статистического выражения.
E_NOINTERFACE
 Указанный класс не реализует запрошенный интерфейс, или управляющий интерфейс IUnknown не предоставляет запрошенный интерфейс.
REGDB_E_CLASSNOTREG
 Указанный класс не зарегистрирован в базе данных регистрации. Это значение также может указывать на то, что тип сервера, запрошенный в типе перечисления CLSCTX, не зарегистрирован или значения для типов серверов в реестре повреждены.

Комментарии

IPrintCoreHelper::CreateInstanceOfMSXMLObject позволяет подключаемым модулям безопасно использовать объекты MSXML, даже если он выполняется на клиентских компьютерах нижнего уровня (то есть клиентских компьютерах под управлением Windows Server 2003, Windows XP или Windows 2000).

Параметры в этом методе сопоставляют непосредственно с параметрами функции CoCreateInstance (которая описана в документации windows SDK). Обратите внимание, что установка драйвера Windows Vista на компьютере под управлением предыдущей версии Windows не приводит к установке MSXML 6.0. Фактическая библиотека DLL включается в библиотеки DLL, зависящие от драйвера, и загружается из каталога драйверов. Он не зарегистрирован в системе. Подключаемые модули, использующие этот метод, должны создавать только объекты MSXML.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть prcomoem.h (включая Prcomoem.h)