IUnknown_GetWindow関数 (shlwapi.h)
GetWindow メソッドを持つさまざまなインターフェイスに対してクエリを実行して、コンポーネント オブジェクト モデル (COM) オブジェクトからウィンドウ ハンドルを取得しようとします。
構文
LWSTDAPI IUnknown_GetWindow(
[in] IUnknown *punk,
[out] HWND *phwnd
);
パラメーター
[in] punk
種類: IUnknown*
この関数がウィンドウ ハンドルの取得を試みる COM オブジェクトへのポインター。
[out] phwnd
種類: HWND*
この関数が正常に返されると、ウィンドウ ハンドルを受け取る HWND へのポインター。 ウィンドウ ハンドルが取得されなかった場合、このパラメーターは NULL に設定されます。
戻り値
種類: HRESULT
ウィンドウ ハンドルが正常に返された場合はS_OKを返し、それ以外の場合は COM エラー コードを返します。 適切なインターフェイスが見つからなかった場合、関数は E_NOINTERFACEを返します。 それ以外の場合、関数は、対応するインターフェイスの GetWindow メソッドによって返される HRESULT を返します。
注釈
この関数は、 IOleWindow::GetWindow、 IInternetSecurityMgrSite::GetWindow、および IShellView::GetWindow を呼び出して、ウィンドウ ハンドルの取得を試みます。 将来のバージョンの IUnknown_GetWindow が追加のインターフェイスを試みる可能性があります。
メモIShellView は IOleWindow から派生しているため、IShellView のクエリは理論的には不要です。 一部のオブジェクトでは QueryInterface が正しく実装されておらず、ベース インターフェイスのクエリに応答できないため、関数はこのインターフェイスに対して明示的にクエリを実行します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server、Windows Server 2003 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shlwapi.h |
[DLL] | Shlwapi.dll (バージョン 5.0 以降) |