LSA_CREATE_TOKEN_EX Rückruffunktion (ntsecpkg.h)

Artikel
08/25/2023

Erstellt Token beim Verarbeiten von Aufrufen von SpAcceptLsaModeContext.

Syntax

LSA_CREATE_TOKEN_EX LsaCreateTokenEx;

NTSTATUS LsaCreateTokenEx(
  [in]  PLUID LogonId,
  [in]  PTOKEN_SOURCE TokenSource,
  [in]  SECURITY_LOGON_TYPE LogonType,
  [in]  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]  LSA_TOKEN_INFORMATION_TYPE TokenInformationType,
  [in]  PVOID TokenInformation,
  [in]  PTOKEN_GROUPS TokenGroups,
  [in]  PUNICODE_STRING Workstation,
  [in]  PUNICODE_STRING ProfilePath,
  [in]  PVOID SessionInformation,
  [in]  SECPKG_SESSIONINFO_TYPE SessionInformationType,
  [out] PHANDLE Token,
  [out] PNTSTATUS SubStatus
)
{...}

Parameter

[in] LogonId

Ein Zeiger auf einen Anmeldesitzungsbezeichner für das neue Token. Dieser Bezeichner wird aus einem vorherigen Aufruf von CreateLogonSession abgerufen.

[in] TokenSource

Ein Zeiger auf eine TOKEN_SOURCE-Struktur , die die Quelle für dieses Token angibt. Geben Sie den Paketnamen an.

[in] LogonType

Ein SECURITY_LOGON_TYPE Wert, der den Anmeldetyp angibt.

[in] ImpersonationLevel

Ein SECURITY_IMPERSONATION_LEVEL Wert, der angibt, in welchem Umfang ein Serverprozess die Identität eines Clientprozesses annehmen kann.

[in] TokenInformationType

Gibt den Strukturtyp im TokenInformation-Parameter an.

Wert	Bedeutung
LsaTokenInformationNull	LSA_TOKEN_INFORMATION_NULL
LsaTokenInformationV1	LSA_TOKEN_INFORMATION_V1

[in] TokenInformation

Ein Zeiger auf die Tokeninformationen. Der Strukturtyp, auf den tokenInformation verweist, wird durch den TokenInformationType-Parameter angegeben.

[in] TokenGroups

Ein Zeiger auf eine TOKEN_GROUPS-Struktur , die Gruppen angibt, die nicht in TokenInformation enthalten sind.

[in] Workstation

Ein Zeiger auf eine UNICODE_STRING Struktur, die den Namen der Arbeitsstation des Clients enthält, normalerweise einen NetBIOS-Namen.

[in] ProfilePath

Ein Zeiger auf eine UNICODE_STRING Struktur, die ggf. den Pfad zum Profil des Benutzers enthält.

[in] SessionInformation

Daten, die Informationen zur aktuellen Anmeldesitzung angeben. Das Format dieser Daten wird durch den Wert des SessionInformationType-Parameters angegeben.

[in] SessionInformationType

Ein Wert der SECPKG_SESSIONINFO_TYPE-Enumeration , der das Format des SessionInformation-Parameters angibt. Derzeit ist der einzige definierte Wert SecSessionPrimaryCred, der angibt, dass der Wert des SessionInformation-Parameters eine SECPKG_PRIMARY_CRED-Struktur ist.

[out] Token

Ein Zeiger, der die Adresse eines Handles auf das neue Token empfängt. Wenn Sie die Verwendung des Handles abgeschlossen haben, schließen Sie es, indem Sie die CloseHandle-Funktion aufrufen.

[out] SubStatus

Ein Zeiger auf eine Variable, die Fehlerinformationen 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 CreateTokenEx-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

Weitere Informationen

SpInitialize

Freigeben über