IIdentityChangeNotify::QuerySwitchIdentities method

[QuerySwitchIdentities is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Called when the current user has requested that their user identity be switched, but before the switch occurs.

Syntax

HRESULT QuerySwitchIdentities();

Parameters

This method has no parameters.

Return value

Type: HRESULT

Result of the switch query. If the switch should proceed, return S_OK. Otherwise, return E_PROCESS_CANCELLED_SWITCH to indicate that the user identity switch should be aborted.

Remarks

You may implement this method to provide custom behavior for your application when a user requests that identities be switched. You can stop the pending identity switch by returning the value E_PROCESS_CANCELLED_SWITCH.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
End of client support
Windows 2000 Professional
End of server support
Windows 2000 Server
Header
Msident.h
IDL
Msident.idl
DLL
Msoe.dll

See also

IIdentityChangeNotify

IIdentityChangeNotify::SwitchIdentities