AuthzInitializeContextFromAuthzContext, fonction (authz.h)
La fonction AuthzInitializeContextFromAuthzContext crée un contexte client basé sur un contexte client existant.
À compter de Windows Server 2012 et Windows 8, cette fonction duplique également les groupes d’appareils, les revendications d’utilisateur et les revendications d’appareil.
Syntaxe
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
);
Paramètres
[in] Flags
Réservé pour un usage futur.
[in] hAuthzClientContext
Handle vers un contexte client existant.
[in, optional] pExpirationTime
Définit la limite de temps pendant laquelle la structure de contexte retournée est valide. Si aucune valeur n’est passée, le jeton n’expire jamais. Le délai d’expiration n’est actuellement pas appliqué.
[in] Identifier
Identificateur spécifique du gestionnaire de ressources.
[in] DynamicGroupArgs
Pointeur vers les paramètres à passer à la fonction de rappel qui calcule les groupes dynamiques. Si la valeur est NULL, la fonction de rappel n’est pas appelée.
[out] phNewAuthzClientContext
Pointeur vers le handle de AUTHZ_CLIENT_CONTEXT_HANDLE dupliqué. Lorsque vous avez terminé d’utiliser le handle, relâchez-le en appelant la fonction AuthzFreeContext .
Valeur retournée
Si la fonction réussit, elle retourne TRUE.
Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Cette fonction appelle la fonction de rappel AuthzComputeGroupsCallback pour ajouter des identificateurs de sécurité au contexte nouvellement créé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | authz.h |
| Bibliothèque | Authz.lib |
| DLL | Authz.dll |
| Composant redistribuable | Windows Server 2003 Administration Tools Pack sur Windows XP |