struktur AUTHZ_ACCESS_REPLY (authz.h)

Artikel
02/26/2024

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

Bagikan melalui