IUserIdentityManager::GetIdentityByCookie method

[GetIdentityByCookie is not supported and may be altered or unavailable in the future. Instead, use User Accounts with Fast User Switching and Remote Desktop.]

Gets a specific user identity by the cookie used to uniquely identify it.

Syntax

HRESULT GetIdentityByCookie(
  [in]  GUID          *uidCookie,
  [out] IUserIdentity **ppIdentity
);

Parameters

uidCookie [in]

Type: GUID*

The address of a GUID value that represents the cookie for the identity you want to retrieve.

ppIdentity [out]

Type: IUserIdentity**

The address of the pointer that will receive the user identity object.

Return value

Type: HRESULT

The result of the retrieval request. If successful, it returns S_OK. Otherwise it will return one of the following error codes.

Return code	Description
E_IDENTITY_NOT_FOUND	The identity requested could not be found.
E_IDENTITIES_DISABLED	Identity management is disabled on the system.

 

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	Msident.dll