Share via


IShellWindows::RegisterPending 方法 (exdisp.h)

將擱置的視窗註冊為殼層視窗;視窗是由絕對 PIDL 所指定。

語法

HRESULT RegisterPending(
        long    lThreadId,
  [in]  VARIANT *pvarloc,
  [in]  VARIANT *pvarlocRoot,
  [in]  int     swClass,
  [out] long    *plCookie
);

參數

lThreadId

執行緒識別碼。

[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 錯誤碼。

備註

在 Shell 視窗集合的內容中, Cookie 是可唯一識別已註冊殼層視窗的權杖。

使用這個方法來註冊擱置中開啟的視窗;如果視窗已經開啟,請改用 IShellWindows::Register 。 使用 IShellWindows::Revoke 取消註冊視窗。

需求

   
目標平台 Windows
標頭 exdisp.h
Dll Shdocvw.dll (5.00.2014.0216 版或更新版本)

另請參閱

IShellWindows

IShellWindows::Register

IShellWindows::Revoke