IShellWindows::OnActivated method (exdisp.h)

Occurs when a Shell window's activation state changes.

Syntax

HRESULT OnActivated(
  [in] long         lCookie,
  [in] VARIANT_BOOL fActive
);

Parameters

[in] lCookie

Type: long

The cookie that identifies the window.

[in] fActive

Type: VARIANT_BOOL

TRUE if the window is being activated; FALSE if the window is being deactivated.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

A window is granted a cookie when it is registered as a Shell window. For more information, see IShellWindows::Register.

Requirements

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

See also

IShellWindows

IShellWindows::OnCreated

IShellWindows::OnNavigate