Bagikan melalui

struktur AUTHZ_ACCESS_REPLY (authz.h)

  • Artikel

Struktur AUTHZ_ACCESS_REPLY mendefinisikan balasan pemeriksaan akses.

Sintaks

typedef struct _AUTHZ_ACCESS_REPLY {
  DWORD        ResultListLength;
  PACCESS_MASK GrantedAccessMask;
  PDWORD       SaclEvaluationResults;
  PDWORD       Error;
} AUTHZ_ACCESS_REPLY, *PAUTHZ_ACCESS_REPLY;

Anggota

ResultListLength

Jumlah elemen dalam array GrantedAccessMask, SaclEvaluationResults, dan Error . Angka ini cocok dengan jumlah entri dalam struktur daftar tipe objek yang digunakan dalam pemeriksaan akses. Jika tidak ada jenis objek yang digunakan untuk mewakili objek, maka atur ResultListLength ke objek.

GrantedAccessMask

Array masker akses yang diberikan. Memori untuk array ini dialokasikan oleh aplikasi sebelum memanggil AccessCheck.

SaclEvaluationResults

Array hasil evaluasi daftar kontrol akses sistem (SACL). Memori untuk array ini dialokasikan oleh aplikasi sebelum memanggil AccessCheck. Evaluasi SACL hanya akan dilakukan jika audit diminta. Setiap elemen anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
AUTHZ_GENERATE_SUCCESS_AUDIT
0x1
 Pesan audit yang menunjukkan keberhasilan dihasilkan.
AUTHZ_GENERATE_FAILURE_AUDIT
0x2
 Pesan audit yang menunjukkan kegagalan dihasilkan.

Error

Array hasil untuk setiap elemen array. Memori untuk array ini dialokasikan oleh aplikasi sebelum memanggil AccessCheck.

Tabel berikut ini mencantumkan kemungkinan nilai kesalahan.

Nilai Makna
ERROR_SUCCESS
 Semua bit akses, tidak termasuk MAXIMUM_ALLOWED, diberikan dan anggota GrantedAccessMask bukan nol.
ERROR_PRIVILEGE_NOT_HELD
 DesiredAccess mencakup ACCESS_SYSTEM_SECURITY dan klien tidak memiliki SeSecurityPrivilege.
ERROR_ACCESS_DENIED
 Termasuk masing-masing hal berikut:
  • Bit yang diminta tidak diberikan.
  • Bit MaximumAllowed aktif dan akses yang diberikan adalah nol.
  • DesiredAccess adalah nol.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header authz.h
Redistribusi Paket Alat Administrasi Windows Server 2003 pada Windows XP

Lihat juga

AccessCheck