Edit

IShellWindows::OnNavigate method (exdisp.h)

  • Article

Occurs when a Shell window is navigated to a new location.

Syntax

HRESULT OnNavigate(
  [in] long    lCookie,
  [in] VARIANT *pvarLoc
);

Parameters

[in] lCookie

Type: long

The cookie that identifies the window.

[in] pvarLoc

Type: VARIANT*

A VARIANT of type VT_VARIANT | VT_BYREF. Set the value of pvarLoc to an absolute PIDL (PIDLIST_ABSOLUTE) that specifies the new location.

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::OnActivated

IShellWindows::OnCreated