IShellWindows::RegisterPending 方法 (exdisp.h)

将挂起的窗口注册为 Shell 窗口;窗口由绝对 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 错误代码。

备注

在 Shell Windows 集合的上下文中, Cookie 是唯一标识已注册的 Shell 窗口的令牌。

使用此方法注册挂起打开的窗口;如果窗口已打开,请改用 IShellWindows::Register 。 使用 IShellWindows::Revoke 取消注册窗口。

要求

   
目标平台 Windows
标头 exdisp.h
DLL Shdocvw.dll (版本 5.00.2014.0216 或更高版本)

请参阅

IShellWindows

IShellWindows::Register

IShellWindows::Revoke