IFileIsInUse::GetSwitchToHWND method (shobjidl_core.h)

Retrieves the handle of the top-level window of the application that is using the file.

Syntax

HRESULT GetSwitchToHWND(
  [out] HWND *phwnd
);

Parameters

[out] phwnd

Type: HWND*

A pointer to an HWND value that, when this method returns successfully, receives the window handle.

Return value

Type: HRESULT

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

Remarks

Only files that return the capability flag OF_CAP_CANSWITCHTO can be switched to.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)