IShellWindows::RegisterPending Method
IShellWindows::RegisterPending Method

Registers a pending window as a Shell window; the window is specified by an absolute PIDL.

Syntax

HRESULT RegisterPending(      
    VARIANT *pvarloc,     VARIANT *pvarlocRoot,     int swClass,     long *plCookie );

Parameters

pvarloc
[in] 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] Must be NULL or of type VT_EMPTY.
swClass
[in] A member of ShellWindowTypeConstants that specifies the type of window.
plCookie
[out] The window's cookie.

Return Value

Returns S_OK if successful, or an error value otherwise.

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.

See Also

© 2009 Microsoft Corporation. All rights reserved.   Terms of Use | Trademarks | Privacy Statement
Page view tracker
Rate the Lightweight library
x
Lightweight builds on ScriptFree (loband) by adding features you've requested: a SearchBox and default code language selection.
Do you like the SearchBox?
Do you like the tabbed code blocks?
How useful is this topic?
Tell us more.
Thanks
x
You're helping to improve MSDN Online.
Feedback
Switch View
Classic
Lightweight Beta
ScriptFree
Switch View