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

Weitere Informationen

AUTHZ_ACCESS_REPLY

Grundlegende Access Control-Funktionen