IWbemUnsecuredApartment::CreateSinkStub メソッド (wbemcli.h)
CreateSinkStub メソッドは IUnsecuredApartment::CreateObjectStub に似ています。オブジェクト フォワーダー シンクを作成し、Windows Management から非同期呼び出しを受信するためのアクセス チェックを実行します。 CreateSinkStub は 、シンクへのコールバックを認証するように指定できるため 、CreateObjectStub とは異なります。
WMI には、個別のプロセスとして機能する Unsecapp.exe プロセスが用意されています。 他のバージョンの Windows では、 IWbemUnsecuredApartment インターフェイスまたは IUnsecuredApartment インターフェイスを呼び出して、Unsecapp.exe をホストできます。 IUnsecuredApartment には、アクセス チェックを実行するメソッドがありません。
アクセス チェックは、最初にシンクを取得したコンピューターのアカウントのみが Unsecapp.exe コールバックを呼び出すことができます。 レジストリ キー UnsecAppAccessControlDefault が 0 に設定されている場合、dwFlag パラメーターが WBEM_FLAG_UNSECAPP_CHECK_ACCESS に設定されたアプリケーションによって CreateSinkStub が呼び出されない限り、Unsecapp.exe はコールバックに対してアクセス制御を実行しません。 パラメーターが存在しない場合 (既定値) は、レジストリ キー値 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\SOFTWARE\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 ポインターを受け取り、非同期 IWbemServices 呼び出しでこのオブジェクトを使用する前に、IID_WbemObjectSinkの QueryInterface を呼び出す必要があります。
戻り値
このメソッドは、 QueryInterface の標準 COM エラー コードを返します。 呼び出しが成功した場合 は、S_OK を返します。 要求されたインターフェイスがサポートされていないために呼び出しが失敗した場合、メソッドは E_NOINTERFACEを返します。
ネットワークの問題によって Windows Management へのリモート接続が失われると、COM 固有のエラー コードも返される可能性があります。
解説
このメソッドは、クライアント アプリケーションからの非同期呼び出しのセキュリティを向上させるために提供されます。 詳細については、「非同期呼び出しでのセキュリティの設定」を参照してください。
要件
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wbemcli.h (Wbemidl.h を含む) |
| Library | Wbemuuid.lib |
| [DLL] | Unsecapp.exe |