Metode IAccessControl::GrantAccessRights (iaccess.h)

Menggabungkan daftar baru hak akses dengan hak akses yang ada pada objek.

Sintaks

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

Parameter

[in] pAccessList

Penunjuk ke struktur ACTRL_ACCESS yang berisi array daftar akses untuk objek.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Menggabungkan daftar hak akses baru dengan hak akses yang ada memastikan bahwa objek akan memiliki setidaknya hak akses yang ditunjukkan. Proses penggabungan ini terdiri dari penambahan hak akses baru yang ditolak sebelum hak akses lama yang ditolak, dan hak akses baru yang diizinkan sebelum hak yang diizinkan yang ada. Tidak ada hak yang ada yang dihapus.

Setelah penggabungan, hak akses pada objek diurutkan sebagai berikut:

1. [Akses Baru Ditolak]
2. [Akses Lama Ditolak]
3. [Akses Baru Diizinkan]
4. [Akses Lama Diizinkan]

Implementasi [ACTRL_ACCESS](.) yang disediakan sistem. Struktur /accctrl/ns-accctrl-explicit_access_a.md) diatur ke 1. Selain itu, anggota lpProperty dari struktur ACTRL_PROPERTY_ENTRYW harus NULL untuk menunjukkan bahwa daftar entri akses berlaku untuk objek itu sendiri.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	iaccess.h

Lihat juga

IAccessControl