Fungsi AuthzModifySids (authz.h)

Artikel
02/26/2024

Fungsi AuthzModifySids menambahkan, menghapus, atau memodifikasi grup pengguna dan perangkat dalam konteks klien Authz.

Sintaks

AUTHZAPI BOOL AuthzModifySids(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE     hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS SidClass,
  [in]           PAUTHZ_SID_OPERATION            pSidOperations,
  [in, optional] PTOKEN_GROUPS                   pSids
);

Parameter

[in] hAuthzClientContext

Handel ke konteks klien yang akan dimodifikasi.

[in] SidClass

Jenis informasi yang akan dimodifikasi. Pemanggil dapat menentukan AuthzContextInfoGroupsSids, AuthzContextInfoRestrictedSids, atau AuthzContextInfoDeviceSids.

[in] pSidOperations

Penunjuk ke array nilai enumerasi AUTHZ_SID_OPERATION yang menentukan modifikasi grup yang akan dibuat.

[in, optional] pSids

Penunjuk ke struktur TOKEN_GROUPS yang menentukan grup yang akan diubah.

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_SID_OPERATION hanya boleh memiliki satu elemen jika nilai elemen tersebut AUTHZ_SID_OPERATION_REPLACE_ALL. Jika tidak, array memiliki jumlah elemen yang sama dengan PTOKEN_GROUPS yang sesuai.

Saat Anda ingin menggunakan AuthzModifySids untuk menghapus, SID dicocokkan tetapi bukan bendera SID. Jika tidak ada SID yang cocok yang ditemukan, tidak ada modifikasi yang dilakukan dan panggilan gagal.

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