ISecurityInformation::GetAccessRights method (aclui.h)

Artikel
03/04/2024

Metode GetAccessRights meminta informasi tentang hak akses yang dapat dikontrol untuk objek yang dapat diamankan. Editor kontrol akses memanggil metode ini untuk mengambil string tampilan dan informasi lain yang digunakan untuk menginisialisasi halaman properti. Untuk informasi selengkapnya, lihat Hak Akses dan Masker Akses.

Sintaks

HRESULT GetAccessRights(
  [in]  const GUID *pguidObjectType,
  [in]  DWORD      dwFlags,
  [out] PSI_ACCESS *ppAccess,
  [out] ULONG      *pcAccesses,
  [out] ULONG      *piDefaultAccess
);

Parameter

[in] pguidObjectType

Penunjuk ke struktur GUID yang mengidentifikasi jenis objek yang hak aksesnya diminta. Jika parameter ini NULL atau pointer ke GUID_NULL, kembalikan hak akses untuk objek yang sedang diedit. Jika tidak, GUID mengidentifikasi jenis objek anak yang dikembalikan oleh metode ISecurityInformation::GetInheritTypes . GUID sesuai dengan anggota InheritedObjectType dari ACE khusus objek.

[in] dwFlags

Sekumpulan bendera bit yang menunjukkan halaman properti sedang diinisialisasi. Nilai ini nol jika halaman keamanan dasar sedang diinisialisasi. Jika tidak, ini adalah kombinasi dari nilai berikut.

Nilai	Makna
SI_ADVANCED	Lembar properti Keamanan Tingkat Lanjut sedang diinisialisasi.
SI_EDIT_AUDITS	Lembar properti Keamanan Tingkat Lanjut menyertakan halaman properti Audit .
SI_EDIT_PROPERTIES	Lembar properti Keamanan Tingkat Lanjut memungkinkan pengeditan ACE yang berlaku untuk properti dan kumpulan properti objek.

[out] ppAccess

Penunjuk ke array struktur SI_ACCESS . Array harus menyertakan satu entri untuk setiap hak akses. Anda dapat menentukan hak akses yang berlaku untuk objek itu sendiri, serta hak akses khusus objek yang hanya berlaku untuk set properti atau properti pada objek.

[out] pcAccesses

Penunjuk ke ULONG yang menunjukkan jumlah entri dalam array ppAccess .

[out] piDefaultAccess

Penunjuk ke ULONG yang menunjukkan indeks berbasis nol dari entri array yang berisi hak akses default. Editor kontrol akses menggunakan entri ini sebagai hak akses awal di ACE baru.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Metode GetAccessRights dipanggil setiap kali halaman properti diinisialisasi.

Editor kontrol akses tidak membebaskan penunjuk yang dikembalikan dalam ppAccess.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	aclui.h