AuthzModifyClaims-Funktion (authz.h)

Artikel
02/23/2024

Die AuthzModifyClaims-Funktion fügt Benutzer- und Geräteansprüche im Authz-Clientkontext hinzu, löscht oder ändert sie.

Syntax

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

Parameter

[in] hAuthzClientContext

Ein Handle für den zu ändernden Clientkontext.

[in] ClaimClass

Art der zu ändernden Informationen. Der Aufrufer kann AuthzContextInfoUserClaims oder AuthzContextInfoDeviceClaims angeben.

[in] pClaimOperations

Ein Zeiger auf ein Array von AUTHZ_SECURITY_ATTRIBUTE_OPERATION Enumerationswerten, die den Typ der Anspruchsänderung angeben, die vorgenommen werden soll.

[in, optional] pClaims

Ein Zeiger auf eine AUTHZ_SECURITY_ATTRIBUTES_INFORMATION-Struktur , die die zu ändernden Ansprüche angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die AUTHZ_SECURITY_ATTRIBUTE_OPERATION-Enumeration darf nur über ein Element verfügen, wenn der Wert dieses Elements AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL ist. Andernfalls weist das Array die gleiche Anzahl von Elementen auf wie das entsprechende PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION.

Wenn die AUTHZ_SECURITY_ATTRIBUTE_OPERATION-Enumeration AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE ist und die Funktion fehlschlägt, rufen Sie GetLastError auf. Wenn der Fehlercode ERROR_ALREADY_EXISTS ist, weisen die Werte des Anspruchs doppelte Einträge auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	authz.h
Bibliothek	Authz.lib
DLL	Authz.dll

Share via