AuthzInitializeContextFromToken, fonction (authz.h)
La fonction AuthzInitializeContextFromToken initialise un contexte d’autorisation client à partir d’un jeton de noyau. Le jeton de noyau doit avoir été ouvert pour TOKEN_QUERY.
À compter de Windows Server 2012 et de Windows 8, cette fonction peut également copier des groupes d’appareils, des revendications d’utilisateur et des revendications d’appareil.
Syntaxe
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
);
Paramètres
[in] Flags
Réservé pour un usage futur.
[in] TokenHandle
Handle du jeton client utilisé pour initialiser le paramètre pAuthzClientContext . Le jeton doit avoir été ouvert avec un accès TOKEN_QUERY.
[in] hAuthzResourceManager
Handle du gestionnaire de ressources qui a créé ce contexte client. Ce handle est stocké dans la structure de contexte client.
[in, optional] pExpirationTime
Date et heure d’expiration du jeton. 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 au gestionnaire de ressources. Ce paramètre n’est actuellement pas utilisé.
[in, optional] DynamicGroupArgs
Pointeur vers les paramètres à passer à la fonction de rappel qui calcule les groupes dynamiques.
[out] phAuthzClientContext
Pointeur vers le handle AuthzClientContext retourné. Appelez AuthzFreeContext lorsque vous avez terminé avec le contexte client.
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 |