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 を使用します。

要件

関連項目

IShellWindows

IShellWindows::Register

IShellWindows::Revoke