This topic has not yet been rated - Rate this topic

GetUserAuthData function

Applies to: desktop apps only

The GetUserAuthData function returns the authorization data for the user in a single buffer.

Syntax

NTSTATUS GetUserAuthData(
  __in   PVOID UserHandle,
  __out  PUCHAR *UserAuthData,
  __out  PULONG UserAuthDataSize
);

Parameters

UserHandle [in]

A handle to the user account. This handle is returned by the OpenSamUser function.

UserAuthData [out]

Pointer that receives the consolidated authorization data. When you have finished using the authorization data, free the memory by calling the FreeLsaHeap function.

UserAuthDataSize [out]

Pointer that receives the size of the authorization data.

Return value

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code indicating the reason it failed.

Remarks

The authorization data returned by the GetUserAuthData function can be passed to the ConvertAuthDataToToken function.

A pointer to the GetUserAuthData function is available in the LSA_SECPKG_FUNCTION_TABLE structure received by the SpInitialize function.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Ntsecpkg.h

See also

ConvertAuthDataToToken
LSA_SECPKG_FUNCTION_TABLE
OpenSamUser
SpInitialize

 

 

Send comments about this topic to Microsoft

Build date: 3/13/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ