LSA_CONVERT_AUTH_DATA_TO_TOKEN回呼函式 (ntsecpkg.h)

發行項
03/13/2024

ConvertAuthDataToToken 函式會從 GetAuthDataForUser 或 GetUserAuthData 函式傳回的授權數據建立存取令牌。

語法

LSA_CONVERT_AUTH_DATA_TO_TOKEN LsaConvertAuthDataToToken;

NTSTATUS LsaConvertAuthDataToToken(
  [in]  PVOID UserAuthData,
  [in]  ULONG UserAuthDataSize,
  [in]  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]  PTOKEN_SOURCE TokenSource,
  [in]  SECURITY_LOGON_TYPE LogonType,
  [in]  PUNICODE_STRING AuthorityName,
  [out] PHANDLE Token,
  [out] PLUID LogonId,
  [out] PUNICODE_STRING AccountName,
  [out] PNTSTATUS SubStatus
)
{...}

參數

[in] UserAuthData

從 GetAuthDataForUser 或 GetUserAuthData 函式收到的授權數據的指標。

[in] UserAuthDataSize

UserAuthData 參數所指定授權數據的大小，以位元組為單位。

[in] ImpersonationLevel

SECURITY_IMPERSONATION_LEVEL值，指定要建立之令牌的模擬層級。

[in] TokenSource

TOKEN_SOURCE結構的指標，指定要在令牌中記錄的來源。

[in] LogonType

SECURITY_LOGON_TYPE值，指出要記錄在令牌中的登入類型。

[in] AuthorityName

UNICODE_STRING 結構的指標，指定授權此用戶的授權單位名稱，通常是功能變數名稱。

[out] Token

接收使用者令牌句柄之 HANDLE 的指標。

當您完成使用使用者令牌時，請呼叫 CloseHandle 以釋放句柄。

[out] LogonId

接收令牌登入標識碼的 LUID 指標。

[out] AccountName

接收 UserAuthData 參數中編碼之帳戶名稱之UNICODE_STRING結構的指標。

[out] SubStatus

變數的指標，該變數會接收函數調用傳回值的其他資訊。

傳回值

如果函式成功，傳回值會STATUS_SUCCESS。

如果函式失敗，則傳回值是NTSTATUS程式代碼，指出失敗的原因。

備註

ConvertAuthDataToToken 函式的指標可在 SpInitialize 函式收到的LSA_SECPKG_FUNCTION_TABLE結構中使用。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	ntsecpkg.h