Platform SDK: Access Control

AreAllAccessesGranted

The AreAllAccessesGranted function checks whether a set of requested access rights has been granted. The access rights are represented as bit flags in an access mask.

BOOL AreAllAccessesGranted(
  DWORD GrantedAccess,  // granted access rights
  DWORD DesiredAccess   // requested access rights
);

Parameters

GrantedAccess
[in] An access mask that specifies the access rights that have been granted.
DesiredAccess
[in] An access mask that specifies the access rights that have been requested. This mask must have been mapped from generic to specific and standard access rights, usually by calling the MapGenericMask function.

Return Values

If all requested access rights have been granted, the return value is nonzero.

If not all requested access rights have been granted, the return value is zero.

Remarks

The AreAllAccessesGranted function is commonly used by a server application to check the access rights of a client attempting to gain access to an object. When the bits set in the DesiredAccess parameter match the bits set in the GrantedAccess parameter, all requested rights have been granted.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Advapi32.lib.

See Also

Client/Server Access Control Overview, Client/Server Access Control Functions, AccessCheck, AreAnyAccessesGranted, MapGenericMask