AuthzInitializeContextFromAuthzContext, fonction (authz.h)

  • Article

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

Voir aussi

AUTHZ_ACCESS_REPLY

Fonctions Access Control de base