IUserIdentity::OpenIdentityRegKey method

[The IUserIdentity::OpenIdentityRegKey method is available for use in Windows 2000. In Windows XP, this functionality has been superseded by User Accounts with Fast User Switching and Remote Desktop, and might be altered or unavailable in subsequent versions.]

Deprecated. Retrieves the key in the registry that corresponds to this user identity.

Syntax

HRESULT OpenIdentityRegKey(
  [in]  DWORD dwDesiredAccess,
  [out] HKEY  *phKey
);

Parameters

dwDesiredAccess [in]

Type: DWORD

A value that describes the access level requested of the registry key.

phKey [out]

Type: HKEY*

A pointer that receives the registry key.

Return value

Type: HRESULT

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

Return code Description
E_IDENTITY_NOT_FOUND
This identity does not have an associated registry key.
E_FAIL
The registry key was unable to be accessed.

 

Remarks

The dwDesiredAccess parameter is a standard registry access security descriptor that describes the access you want to gain to the registry key. For more information on registry security, including a list of acceptable values for this parameter, see Registry Key Security and Access Rights.

Requirements

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

See also

IUserIdentity

IUserIdentity::GetIdentityFolder