LSA_CONVERT_AUTH_DATA_TO_TOKEN Rückruffunktion (ntsecpkg.h)

Artikel
02/29/2024

Die ConvertAuthDataToToken-Funktion erstellt ein Zugriffstoken aus den Autorisierungsdaten, die von den Funktionen GetAuthDataForUser oder GetUserAuthData zurückgegeben werden.

Syntax

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
)
{...}

Parameter

[in] UserAuthData

Zeiger auf die Autorisierungsdaten, die von den Funktionen GetAuthDataForUser oder GetUserAuthData empfangen werden.

[in] UserAuthDataSize

Größe der vom UserAuthData-Parameter angegebenen Autorisierungsdaten in Byte.

[in] ImpersonationLevel

Ein SECURITY_IMPERSONATION_LEVEL Wert, der die Identitätswechselebene für das zu erstellende Token angibt.

[in] TokenSource

Zeiger auf eine TOKEN_SOURCE-Struktur , die die Quelle angibt, die im Token erfasst werden soll.

[in] LogonType

Ein SECURITY_LOGON_TYPE Wert, der den Anmeldetyp angibt, der im Token erfasst werden soll.

[in] AuthorityName

Zeiger auf eine UNICODE_STRING-Struktur , die den Namen der Autorität angibt, die diesen Benutzer autorisiert hat, in der Regel einen Domänennamen.

[out] Token

Zeiger auf ein HANDLE, das das Benutzertokenhandle empfängt.

Wenn Sie die Verwendung des Benutzertokens abgeschlossen haben, geben Sie das Handle durch Aufrufen von CloseHandle frei.

[out] LogonId

Zeiger auf eine LUID , die den Anmeldebezeichner für das Token empfängt.

[out] AccountName

Zeiger auf eine UNICODE_STRING-Struktur , die den im UserAuthData-Parameter codierten Kontonamen empfängt.

[out] SubStatus

Zeiger auf eine Variable, die zusätzliche Informationen zum Rückgabewert des Funktionsaufrufs empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code, der den Grund für den Fehler angibt.

Hinweise

Ein Zeiger auf die ConvertAuthDataToToken-Funktion ist in der LSA_SECPKG_FUNCTION_TABLE-Struktur verfügbar, die von der SpInitialize-Funktion empfangen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecpkg.h