IShellWindows::Revoke method (exdisp.h)

Revokes a Shell window's registration and removes the window from the Shell windows collection.

Syntax

HRESULT Revoke(
  [in] long lCookie
);

Parameters

[in] lCookie

Type: long*

The cookie that identifies the window to un-register.

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 the IShellWindows::Register method to register an open window by handle. Use the IShellWindows::RegisterPending method to register a pending-open window by absolute PIDL.

Requirements

Requirement Value
Target Platform Windows
Header exdisp.h
DLL Shdocvw.dll (version 5.00.2014.0216 or later)

See also

IShellWindows

IShellWindows::Register

IShellWindows::RegisterPending