AuthzInitializeContextFromAuthzContext-Funktion (authz.h)
Die Funktion AuthzInitializeContextFromAuthzContext erstellt einen neuen Clientkontext basierend auf einem vorhandenen Clientkontext.
Ab Windows Server 2012 und Windows 8 dupliziert diese Funktion auch Gerätegruppen, Benutzeransprüche und Geräteansprüche.
Syntax
AUTHZAPI BOOL AuthzInitializeContextFromAuthzContext(
[in] DWORD Flags,
[in] AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
[in, optional] PLARGE_INTEGER pExpirationTime,
[in] LUID Identifier,
[in] PVOID DynamicGroupArgs,
[out] PAUTHZ_CLIENT_CONTEXT_HANDLE phNewAuthzClientContext
);
Parameter
[in] Flags
Für die zukünftige Verwendung reserviert.
[in] hAuthzClientContext
Das Handle für einen vorhandenen Clientkontext.
[in, optional] pExpirationTime
Legt das Zeitlimit für die Gültigkeitsdauer der zurückgegebenen Kontextstruktur fest. Wenn kein Wert übergeben wird, läuft das Token nie ab. Die Ablaufzeit wird derzeit nicht erzwungen.
[in] Identifier
Der spezifische Bezeichner für den Ressourcen-Manager.
[in] DynamicGroupArgs
Ein Zeiger auf Parameter, die an die Rückruffunktion übergeben werden sollen, die dynamische Gruppen berechnet. Wenn der Wert NULL ist, wird die Rückruffunktion nicht aufgerufen.
[out] phNewAuthzClientContext
Ein Zeiger auf das duplizierte AUTHZ_CLIENT_CONTEXT_HANDLE-Handle. Wenn Sie die Verwendung des Handles abgeschlossen haben, lassen Sie es los, indem Sie die AuthzFreeContext-Funktion aufrufen.
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 |