SetTokenInformation-Funktion (securitybaseapi.h)

Artikel
03/01/2024

Die SetTokenInformation-Funktion legt verschiedene Arten von Informationen für ein angegebenes Zugriffstoken fest. Die von dieser Funktion festgelegten Informationen ersetzen vorhandene Informationen. Der aufrufende Prozess muss über die entsprechenden Zugriffsrechte verfügen, um die Informationen festzulegen.

Syntax

BOOL SetTokenInformation(
  [in] HANDLE                  TokenHandle,
  [in] TOKEN_INFORMATION_CLASS TokenInformationClass,
  [in] LPVOID                  TokenInformation,
  [in] DWORD                   TokenInformationLength
);

Parameter

[in] TokenHandle

Ein Handle für das Zugriffstoken, für das Informationen festgelegt werden sollen.

[in] TokenInformationClass

Ein Wert aus dem TOKEN_INFORMATION_CLASS aufgezählten Typ, der den Informationstyp identifiziert, den die Funktion festlegt. Die gültigen Werte aus TOKEN_INFORMATION_CLASS werden im TokenInformation-Parameter beschrieben.

[in] TokenInformation

Ein Zeiger auf einen Puffer, der die im Zugriffstoken festgelegten Informationen enthält. Die Struktur dieses Puffers hängt vom Typ der Informationen ab, die durch den TokenInformationClass-Parameter angegeben werden.

[in] TokenInformationLength

Gibt die Länge des Puffers in Bytes an, auf den tokenInformation verweist.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null zurück.

Wenn die Funktion fehlschlägt, wird null zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Um Berechtigungsinformationen festzulegen, kann eine Anwendung die Funktion AdjustTokenPrivileges aufrufen. Um die Gruppen eines Tokens festzulegen, kann eine Anwendung die Funktion AdjustTokenGroups aufrufen.

Tokentypinformationen können nur festgelegt werden, wenn ein Zugriffstoken erstellt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (Einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll