AuthzInitializeContextFromToken-Funktion (authz.h)
Die AuthzInitializeContextFromToken-Funktion initialisiert einen Clientautorisierungskontext aus einem Kerneltoken. Das Kerneltoken muss für TOKEN_QUERY geöffnet worden sein.
Ab Windows Server 2012 und Windows 8 kann diese Funktion auch Gerätegruppen, Benutzeransprüche und Geräteansprüche kopieren.
Syntax
AUTHZAPI BOOL AuthzInitializeContextFromToken(
[in] DWORD Flags,
[in] HANDLE TokenHandle,
[in] AUTHZ_RESOURCE_MANAGER_HANDLE hAuthzResourceManager,
[in, optional] PLARGE_INTEGER pExpirationTime,
[in] LUID Identifier,
[in, optional] PVOID DynamicGroupArgs,
[out] PAUTHZ_CLIENT_CONTEXT_HANDLE phAuthzClientContext
);
Parameter
[in] Flags
Für die zukünftige Verwendung reserviert.
[in] TokenHandle
Ein Handle für das Clienttoken, das zum Initialisieren des pAuthzClientContext-Parameters verwendet wird. Das Token muss mit TOKEN_QUERY Zugriff geöffnet worden sein.
[in] hAuthzResourceManager
Ein Handle für den Ressourcen-Manager, der diesen Clientkontext erstellt hat. Dieses Handle wird in der Clientkontextstruktur gespeichert.
[in, optional] pExpirationTime
Ablaufdatum und -uhrzeit des Tokens. Wenn kein Wert übergeben wird, läuft das Token nie ab. Die Ablaufzeit wird derzeit nicht erzwungen.
[in] Identifier
Bezeichner, der für den Ressourcen-Manager spezifisch ist. Dieser Parameter wird derzeit nicht verwendet.
[in, optional] DynamicGroupArgs
Ein Zeiger auf Parameter, die an die Rückruffunktion übergeben werden sollen, die dynamische Gruppen berechnet.
[out] phAuthzClientContext
Ein Zeiger auf das zurückgegebene Handle "AuthzClientContext ". Rufen Sie AuthzFreeContext auf, wenn Sie mit dem Clientkontext fertig sind.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück.
Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Diese Funktion ruft die Rückruffunktion AuthzComputeGroupsCallback auf, um dem neu erstellten Kontext Sicherheitsbezeichner hinzuzufügen.
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 | authz.h |
| Bibliothek | Authz.lib |
| DLL | Authz.dll |
| Verteilbare Komponente | Windows Server 2003 Administration Tools Pack unter Windows XP |