Fungsi AuthzModifyClaims (authz.h)

Artikel
02/23/2024

Fungsi AuthzModifyClaims menambahkan, menghapus, atau memodifikasi klaim pengguna dan perangkat dalam konteks klien Authz.

Sintaks

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

Handel ke konteks klien yang akan dimodifikasi.

[in] ClaimClass

Jenis informasi yang akan dimodifikasi. Pemanggil dapat menentukan AuthzContextInfoUserClaims atau AuthzContextInfoDeviceClaims.

[in] pClaimOperations

Penunjuk ke array nilai enumerasi AUTHZ_SECURITY_ATTRIBUTE_OPERATION yang menentukan jenis modifikasi klaim yang akan dibuat.

[in, optional] pClaims

Penunjuk ke struktur AUTHZ_SECURITY_ATTRIBUTES_INFORMATION yang menentukan klaim untuk dimodifikasi.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Enumerasi AUTHZ_SECURITY_ATTRIBUTE_OPERATION hanya boleh memiliki satu elemen jika nilai elemen tersebut AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL. Jika tidak, array memiliki jumlah elemen yang sama dengan PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION yang sesuai.

Jika enumerasi AUTHZ_SECURITY_ATTRIBUTE_OPERATION AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE dan fungsi gagal, panggil GetLastError. Jika kode kesalahan ERROR_ALREADY_EXISTS, nilai klaim memiliki entri duplikat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	authz.h
Pustaka	Authz.lib
DLL	Authz.dll

Bagikan melalui