LSA_GET_USER_AUTH_DATA callback function (ntsecpkg.h)

Article
02/22/2024

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

Syntax

LSA_GET_USER_AUTH_DATA LsaGetUserAuthData;

NTSTATUS LsaGetUserAuthData(
  [in]  PVOID UserHandle,
  [out] PUCHAR *UserAuthData,
  [out] PULONG UserAuthDataSize
)
{...}

Parameters

[in] UserHandle

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

[out] UserAuthData

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

[out] UserAuthDataSize

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

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	ntsecpkg.h