TrusteeAccessToObject

[This is preliminary documentation and subject to change.]

The TrusteeAccessToObject function determines whether a trustee has specified access rights to a specified object or its properties.

DWORD TrusteeAccessToObject(
  LPCTSTR lpObject,   // name of the object
  SE_OBJECT_TYPE ObjectType,
                      // type of object
  LPCTSTR lpProvider, // name of provider to handle request
  PTRUSTEE pTrustee,  // pointer to trustee information
  ULONG cEntries,     // number of entries in trustee access list
  PTRUSTEE_ACCESS pTrusteeAccess
                      // pointer to a trustee access list
);
 

Parameters

lpObject

Pointer to a null-terminated string that specifies the name of an object. For descriptions of the string formats for the different object types, see SE_OBJECT_TYPE.

ObjectType

Specifies a value from the SE_OBJECT_TYPE enumeration that indicates the type of object named by the lpObject parameter.

lpProvider

Pointer to a null-terminated string that specifies the name of the provider to handle the request. If this parameter is NULL, the system determines the proper provider to handle the request.

pTrustee

Pointer to a TRUSTEE structure that identifies a user, group, or program (such as a Win32 service).

cEntries

Specifies the number of entries in the array of TRUSTEE_ACCESS structures.

pTrusteeAccess

Pointer to an array of TRUSTEE_ACCESS structures. Each entry specifies the access rights to check. An entry can check access rights to the object or to a property set or property on the object. When the function returns successfully, the fReturnedAccess member of each structure indicates whether the trustee has the requested access rights.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value can be one of the following error codes.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in aclapi.h.
  Import Library: Use advapi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Access Control Overview, Access Control Functions, SE_OBJECT_TYPE, TRUSTEE, TRUSTEE_ACCESS