Метод IWbemUnsecuredApartment::CreateSinkStub (wbemcli.h)
Метод CreateSinkStub аналогичен методу IUnsecuredApartment::CreateObjectStub и создает приемник пересылки объектов и выполняет проверки доступа для получения асинхронных вызовов из управления Windows. CreateSinkStub отличается от CreateObjectStub , так как он может указать, что обратные вызовы в приемник должны проходить проверку подлинности.
WMI предоставляет процесс Unsecapp.exe для работы в качестве отдельного процесса. Вы можете разместить Unsecapp.exe с помощью вызова интерфейса IWbemUnsecuredApartment или интерфейса IUnsecuredApartment в других версиях Windows. В IUnsecuredApartment нет методов, выполняющих проверку доступа.
Проверка доступа означает, что Unsecapp.exe позволяет только учетной записи компьютера, который первоначально получил приемник для вызова обратных вызовов. Если для раздела реестра UnsecAppAccessControlDefault задано нулевое значение, Unsecapp.exe не выполняет управление доступом к обратным вызовам, если приложение не вызывает CreateSinkStub с параметром dwFlag , равным WBEM_FLAG_UNSECAPP_CHECK_ACCESS. Если параметр отсутствует, то по умолчанию Unsecapp.exe считывает значение раздела реестра, чтобы определить, следует ли проверять подлинность обратных вызовов.
Синтаксис
HRESULT CreateSinkStub(
[in] IWbemObjectSink *pSink,
[in] DWORD dwFlags,
LPCWSTR wszReserved,
[out] IWbemObjectSink **ppStub
);
Параметры
[in] pSink
Указатель на внутрипроцессную реализацию IWbemObjectSink.
[in] dwFlags
Можно задать одно из следующих значений из перечисления WBEM_UNSECAPP_FLAG_TYPE . Этот параметр определяет, как Unsecapp.exe использует раздел реестра, проверяет этот раздел реестра:
HKEY_LOCAL_MACHINE\ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ\Microsoft\WBEM\CIMOM\UnsecAppAccessControlDefault
WBEM_FLAG_UNSECAPP_DEFAULT_CHECK_ACCESS
Unsecapp.exe считывает раздел реестра UnsecAppAccessControlDefault , чтобы определить, следует ли проверять подлинность обратных вызовов.
WBEM_FLAG_UNSECAPP_CHECK_ACCESS
Unsecapp.exe выполняет проверку подлинности обратных вызовов независимо от параметра раздела реестра UnsecAppAccessControlDefault.
WBEM_FLAG_UNSECAPP_DONT_CHECK_ACCESS
Unsecapp.exe не выполняет проверку подлинности обратных вызовов независимо от параметра раздела реестра UnsecAppAccessControlDefault.
wszReserved
Зарезервировано.
[out] ppStub
Получает указатель на замещающий объект, используемый в асинхронных вызовах IWbemServices . Пользователь получает указатель IUnknown и должен вызывать QueryInterface для IID_WbemObjectSink перед использованием этого объекта в асинхронных вызовах IWbemServices .
Возвращаемое значение
Этот метод возвращает стандартные коды ошибок COM для QueryInterface. Он возвращает S_OK , если вызов выполнен успешно. Если вызов завершается сбоем, так как запрошенный интерфейс не поддерживается, метод возвращает E_NOINTERFACE.
Коды ошибок, относящиеся к COM, также могут быть возвращены, если проблемы с сетью приводят к потере удаленного подключения к управлению Windows.
Комментарии
Этот метод предоставляется для повышения безопасности асинхронных вызовов из клиентских приложений. Дополнительные сведения см. в разделе "Настройка безопасности для асинхронного вызова".
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wbemcli.h (include Wbemidl.h) |
| Библиотека | Wbemuuid.lib |
| DLL | Unsecapp.exe |
См. также раздел
IUnsecuredApartment::CreateObjectStub