AuthzModifyClaims, fonction (authz.h)

  • Article

La fonction AuthzModifyClaims ajoute, supprime ou modifie des revendications d’utilisateur et d’appareil dans le contexte client Authz.

Syntaxe

AUTHZAPI BOOL AuthzModifyClaims(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE            hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS        ClaimClass,
  [in]           PAUTHZ_SECURITY_ATTRIBUTE_OPERATION    pClaimOperations,
  [in, optional] PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION pClaims
);

Paramètres

[in] hAuthzClientContext

Handle du contexte client à modifier.

[in] ClaimClass

Type d’informations à modifier. L’appelant peut spécifier AuthzContextInfoUserClaims ou AuthzContextInfoDeviceClaims.

[in] pClaimOperations

Pointeur vers un tableau de valeurs d’énumération AUTHZ_SECURITY_ATTRIBUTE_OPERATION qui spécifient le type de modification de revendication à effectuer.

[in, optional] pClaims

Pointeur vers une structure AUTHZ_SECURITY_ATTRIBUTES_INFORMATION qui spécifie les revendications à modifier.

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

L’énumération AUTHZ_SECURITY_ATTRIBUTE_OPERATION ne doit avoir qu’un seul élément si la valeur de cet élément est AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL. Sinon, le tableau a le même nombre d’éléments que le PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION correspondant.

Si l’énumération AUTHZ_SECURITY_ATTRIBUTE_OPERATION est AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE et que la fonction échoue, appelez GetLastError. Si le code d’erreur est ERROR_ALREADY_EXISTS, les valeurs de la revendication ont des entrées en double.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête authz.h
Bibliothèque Authz.lib
DLL Authz.dll