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

Статья
02/07/2025

Метод 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 (описано в документации по пакету SDK для Microsoft Windows).

[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 (которая описана в документации по пакету SDK для Windows). Обратите внимание, что установка драйвера Windows Vista на компьютере под управлением предыдущей версии Windows не приводит к установке MSXML 6.0. Фактическая библиотека DLL включается в библиотеки DLL, зависящие от драйвера, и загружается из каталога драйверов. Он не зарегистрирован в системе. Подключаемые модули, использующие этот метод, должны создавать только объекты MSXML.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prcomoem.h (include Prcomoem.h)

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