ISecurityInformation::GetAccessRights method (aclui.h)
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.
[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 |
Lihat juga
Access Control Editor Functions