Метод IUnsecuredApartment::CreateObjectStub (wbemcli.h)

Статья
03/03/2024

Метод CreateObjectStub создает приемник сервера пересылки объектов для получения асинхронных вызовов из управления Windows. Эта функция привязывает приемник незащищенных объектов к локальному приемнику объектов, чтобы безопасность COM не влияла на асинхронное получение объектов CIM. Так как безопасность COM обходится, удаленный сервер управления Windows считается доверенным компонентом.

Общая парадигма заключается в том, что исходная реализация IWbemObjectSink в клиентском процессе не используется непосредственно в асинхронных вызовах IWbemServices. Скорее, и исходная реализация, и замещающий объект создаются, связываются вместе, а затем замещающий объект используется в асинхронных методах IWbemServices.

Синтаксис

HRESULT CreateObjectStub(
  [in]  IUnknown *pObject,
  [out] IUnknown **ppStub
);

Параметры

[in] pObject

Указатель на внутрипроцессную реализацию IWbemObjectSink в клиенте.

[out] ppStub

Получает указатель на замещающий объект для использования в асинхронных вызовах IWbemServices . Пользователь получает указатель IUnknown и должен вызвать QueryInterface для IID_WbemObjectSink , прежде чем использовать этот объект в асинхронных вызовах IWbemServices .

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

Этот метод возвращает стандартные коды com-ошибок для QueryInterface. Он возвращает S_OK , если вызов выполнен успешно. Если вызов завершается сбоем, так как запрошенный интерфейс не поддерживается, метод возвращает E_NOINTERFACE.

Коды ошибок, относящихся к COM, также могут быть возвращены, если проблемы с сетью приводят к потере удаленного подключения к управлению Windows.

Примечание Так как обратный вызов в приемник может быть возвращен не на том же уровне проверки подлинности, который требуется клиенту, рекомендуется использовать полусинхронный режим вместо асинхронного взаимодействия. Дополнительные сведения см. в разделе Вызов метода .

Примеры

Полный пример использования интерфейса IUnsecuredApartment см. в разделе Пример. Получение уведомлений о событиях через WMI.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008 R2
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Unsecapp.exe