Funzione AuthzModifyClaims (authz.h)

La funzione AuthzModifyClaims aggiunge, elimina o modifica le attestazioni utente e dispositivo nel contesto client Authz.

Sintassi

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
);

Parametri

[in] hAuthzClientContext

Handle per il contesto client da modificare.

[in] ClaimClass

Tipo di informazioni da modificare. Il chiamante può specificare AuthzContextInfoUserClaims o AuthzContextInfoDeviceClaims.

[in] pClaimOperations

Puntatore a una matrice di AUTHZ_SECURITY_ATTRIBUTE_OPERATION valori di enumerazione che specificano il tipo di modifica dell'attestazione da apportare.

[in, optional] pClaims

Puntatore a una struttura AUTHZ_SECURITY_ATTRIBUTES_INFORMATION che specifica le attestazioni da modificare.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

L'enumerazione AUTHZ_SECURITY_ATTRIBUTE_OPERATION deve avere un solo elemento se il valore di tale elemento è AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL. In caso contrario, la matrice ha lo stesso numero di elementi del PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION corrispondente.

Se l'enumerazione AUTHZ_SECURITY_ATTRIBUTE_OPERATION è AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE e la funzione ha esito negativo, chiamare GetLastError. Se il codice di errore è ERROR_ALREADY_EXISTS, i valori dell'attestazione hanno voci duplicate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	authz.h
Libreria	Authz.lib
DLL	Authz.dll