SetTokenInformation-Funktion (securitybaseapi.h)
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 |