IShellWindows::RegisterPending メソッド (exdisp.h)
保留中のウィンドウをシェル ウィンドウとして登録します。ウィンドウは絶対 PIDL で指定されます。
構文
HRESULT RegisterPending(
long lThreadId,
[in] VARIANT *pvarloc,
[in] VARIANT *pvarlocRoot,
[in] int swClass,
[out] long *plCookie
);
パラメーター
lThreadId
スレッド ID。
[in] pvarloc
型: VARIANT*
VT_VARIANT型の VARIANT |VT_BYREF。 pvarloc の値を、登録するウィンドウを指定する絶対 PIDL (PIDLIST_ABSOLUTE) に設定します。
[in] pvarlocRoot
型: VARIANT*
NULL または型VT_EMPTYである必要があります。
[in] swClass
型: int
ウィンドウの種類を指定する ShellWindowTypeConstants のメンバー。
[out] plCookie
型: long*
ウィンドウの Cookie。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
解説
シェル ウィンドウ コレクションのコンテキストでは、 Cookie は、登録済みのシェル ウィンドウを一意に識別するトークンです。
開いている保留中のウィンドウを登録するには、このメソッドを使用します。ウィンドウが既に開いている場合は、代わりに IShellWindows::Register を 使用します。 ウィンドウの登録を解除するには、 IShellWindows::Revoke を使用します。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | exdisp.h |
| [DLL] | Shdocvw.dll (バージョン 5.00.2014.0216 以降) |