IAccessControl::IsAccessAllowed method (iaccess.h)

Menentukan apakah wali yang ditentukan memiliki hak akses ke objek atau properti.

Sintaks

HRESULT IsAccessAllowed(
  [in]  PTRUSTEEW     pTrustee,
  [in]  LPWSTR        lpProperty,
  [in]  ACCESS_RIGHTS AccessRights,
  [out] BOOL          *pfAccessAllowed
);

Parameter

[in] pTrustee

Penunjuk ke struktur TRUSTEE .

[in] lpProperty

Nama properti. Jika Anda menggunakan implementasi COM dari IAccessControl, parameter ini harus NULL.

[in] AccessRights

Hak akses pada objek. Jika Anda menggunakan implementasi COM IAccessControl, nilai ini harus 0 atau 1 (COM_RIGHTS_EXECUTE).

[out] pfAccessAllowed

Menunjukkan apakah akses diizinkan.

Nilai kembali

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

Keterangan

Dalam implementasi IAccessControl yang disediakan sistem (CLSID_DCOMAccessControl), IsAccessAllowed hanya dapat dipanggil selama panggilan COM terdistribusi, dan satu-satunya nama wali yang valid adalah nama klien.

Tabel berikut mencantumkan izin akses khusus objek yang digunakan dengan Layanan Direktori dan implementasi penyimpanan IAccessControl.

Izin berikut khusus untuk objek DS.

Izin akses	Deskripsi
ACTRL_DS_OPEN	Membuka objek DS
ACTRL_DS_CREATE_CHILD	Membuat objek anak
ACTRL_DS_DELETE_CHILD	Menghapus objek anak
ACTRL_DS_LIST	Menghitung objek
ACTRL_DS_SELF	Memperbarui daftar anggota yang melibatkan wali amanat
ACTRL_DS_READ_PROP	Membaca properti
ACTRL_DS_WRITE_PROP	Properti tulis

 

Izin berikut ini khusus untuk objek file.

Izin akses	Deskripsi
ACTRL_FILE_READ	Membaca dari file
ACTRL_FILE_WRITE	Menulis ke file
ACTRL_FILE_APPEND	Menambahkan ke file
ACTRL_FILE_READ_PROP	Membaca properti file atau atribut yang diperluas
ACTRL_FILE_WRITE_PROP	Menulis properti file atau atribut yang diperluas
ACTRL_FILE_EXECUTE	Jalankan file
ACTRL_FILE_READ_ATTRIB	Membaca atribut file
ACTRL_FILE_WRITE_ATTRIB	Menulis atribut file

 

Izin berikut ini khusus untuk objek direktori.

Izin akses	Deskripsi
ACTRL_DIR_LIST	Mencantumkan konten direktori
ACTRL_DIR_CREATE_OBJECT	Membuat objek anak (file) dalam direktori
ACTRL_DIR_CREATE_CHILD	Membuat subdirektori
ACTRL_DIR_DELETE_CHILD	Menghapus subdirektori
ACTRL_DIR_TRAVERSE	Melintasi direktori

 

Izin berikut khusus untuk objek kernel.

Izin akses	Deskripsi
ACTRL_KERNEL_TERMINATE	Mengakhiri proses atau utas
ACTRL_KERNEL_THREAD	Membuat utas
ACTRL_KERNEL_VM	Melakukan operasi ruang alamat
ACTRL_KERNEL_VM_READ	Membaca dari memori
ACTRL_KERNEL_VM_WRITE	Menulis ke memori
ACTRL_KERNEL_DUP_HANDLE	Menduplikasi handel
ACTRL_KERNEL_PROCESS	Membuat proses
ACTRL_KERNEL_SET_INFO	Mendapatkan informasi atau status objek kernel
ACTRL_KERNEL_GET_INFO	Mengatur informasi atau status objek kernel
ACTRL_KERNEL_CONTROL	Mengontrol objek kernel (seperti menangguhkan utas)
ACTRL_KERNEL_ALERT	Memperingatkan objek kernel.
ACTRL_KERNEL_GET_CONTEXT	Mendapatkan konteks utas
ACTRL_KERNEL_SET_CONTEXT	Mengatur konteks utas
ACTRL_KERNEL_TOKEN	Mengatur token utas
ACTRL_KERNEL_IMPERSONATE	Meniru klien
ACTRL_KERNEL_DIMPERSONATE	Meniru klien secara langsung

 

Izin berikut ini khusus untuk objek printer.

Izin akses	Deskripsi
ACTRL_PRINT_SADMIN	Mengelola server cetak
ACTRL_PRINT_SLIST	Menghitung server cetak
ACTRL_PRINT_PADMIN	Mengelola printer
ACTRL_PRINT_PUSE	Gunakan printer
ACTRL_PRINT_JADMIN	Mengelola pekerjaan cetak

 

Izin berikut ini khusus untuk objek layanan.

Izin akses	Deskripsi
ACTRL_SVC_GET_INFO	Memulai layanan
ACTRL_SVC_SET_INFO	Menghentikan layanan
ACTRL_SVC_STATUS	Menjeda layanan
ACTRL_SVC_LIST	Menghitung layanan
ACTRL_SVC_START	Memulai layanan
ACTRL_SVC_STOP	Menghentikan layanan
ACTRL_SVC_PAUSE	Menjeda layanan
ACTRL_SVC_INTERROGATE	Mengkueri layanan untuk status saat ini
ACTRL_SVC_UCONTROL	Kontrol yang ditentukan pengguna

 

Izin berikut ini khusus untuk objek registri.

Izin akses	Deskripsi
ACTRL_REG_QUERY	Membaca subkuntang registri
ACTRL_REG_SET	Menulis subkuntang registri
ACTRL_REG_CREATE_CHILD	Membuat subkunci registri
ACTRL_REG_LIST	Menghitung subkunci registri
ACTRL_REG_NOTIFY	Membuat pemberitahuan registri
ACTRL_REG_LINK	Membuat tautan simbolis

 

Izin berikut ini khusus untuk objek jendela.

Izin akses	Deskripsi
ACTRL_WIN_CLIPBRD	Aktifkan akses ke clipboard
ACTRL_WIN_GLOBAL_ATOMS	Mengaktifkan akses global-atom
ACTRL_WIN_CREATE	Membuat akses desktop
ACTRL_WIN_LIST_DESK	Menghitung desktop
ACTRL_WIN_LIST	Menghitung stasiun jendela
ACTRL_WIN_READ_ATTRIBS	Membaca atribut
ACTRL_WIN_WRITE_ATTRIBS	Menulis atribut
ACTRL_WIN_SCREEN	Aktifkan akses ke layar
ACTRL_WIN_EXIT	Memanggil ExitWindows atau ExitWindowsEx

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