TrusteeAccessToObject info  Overview  Group

[This is a preview of an interface that may appear in future releases of Windows.]

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 Windows NT 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 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.

Value	Meaning
ERROR_BAD_PROVIDER	The lpProvider parameter specified an invalid provider name.
ERROR_INVALID_PARAMETER	An invalid parameter was specified.

Remarks

Currently, the import library for the TrusteeAccessToObject function is ACCSRC.LIB. This is temporary. Eventually, the import library will be ADVAPI32.LIB. Meanwhile, any source code that links with the ACCSRC.LIB library must call the AccProvInit macro as follows:

    DWORD dwErrcode;



    AccProvInit(dwErrcode);

    if(dwErrcode != ERROR_SUCCESS)

    {

         // Consider this an error...

    }

 

See Also

SE_OBJECT_TYPE, TRUSTEE, TRUSTEE_ACCESS