IShellWindows::RegisterPending method
Registers a pending window as a Shell window; the window is specified by an absolute PIDL.
Syntax
HRESULT RegisterPending( [in] VARIANT *pvarloc, [in] VARIANT *pvarlocRoot, [in] int swClass, [out] long *plCookie );
Parameters
- pvarloc [in]
-
Type: VARIANT*
A VARIANT of type VT_VARIANT | VT_BYREF. Set the value of pvarloc to an absolute PIDL (PIDLIST_ABSOLUTE) that specifies the window to register.
- pvarlocRoot [in]
-
Type: VARIANT*
Must be NULL or of type VT_EMPTY.
- swClass [in]
-
Type: int
A member of ShellWindowTypeConstants that specifies the type of window.
- plCookie [out]
-
Type: long*
The window's cookie.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
In the context of the Shell windows collection, a cookie is a token that uniquely identifies a registered Shell window.
Use this method to register a window that is pending open; if the window is already open, use IShellWindows::Register instead. Use IShellWindows::Revoke to un-register a window.
Requirements
|
Product |
Internet Explorer 5 |
|---|---|
|
Header |
|
|
IDL |
|
|
DLL |
|
See also