AuthzInitializeContextFromToken, fonction (authz.h)

  • Article

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

Voir aussi

AuthzFreeContext

Fonctions Access Control de base