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 |