Fungsi AreAnyAccessesGranted (securitybaseapi.h)

Artikel
03/04/2024

Fungsi AreAnyAccessesGranted menguji apakah salah satu dari sekumpulan hak akses yang diminta telah diberikan. Hak akses direpresentasikan sebagai bendera bit dalam masker akses.

Sintaks

BOOL AreAnyAccessesGranted(
  [in] DWORD GrantedAccess,
  [in] DWORD DesiredAccess
);

Parameter

[in] GrantedAccess

Menentukan masker akses yang diberikan.

[in] DesiredAccess

Menentukan masker akses yang akan diminta. Masker ini harus dipetakan dari umum ke hak akses tertentu dan standar, biasanya dengan memanggil fungsi MapGenericMask .

Nilai kembali

Jika salah satu hak akses yang diminta telah diberikan, nilai yang dikembalikan bukan nol.

Jika tidak ada hak akses yang diminta yang diberikan, nilai yang dikembalikan adalah nol.

Keterangan

Fungsi AreAnyAccessesGranted sering digunakan oleh aplikasi server untuk memeriksa hak akses klien yang mencoba mendapatkan akses ke objek. Ketika salah satu bit yang diatur dalam parameter DesiredAccess cocok dengan bit yang ditetapkan dalam parameter GrantedAccess , setidaknya salah satu hak akses yang diminta telah diberikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll