BuildTrusteeWithObjectsAndNameA function

The BuildTrusteeWithObjectsAndName function initializes a TRUSTEE structure with the object-specific access control entry (ACE) information and initializes the remaining members of the structure to default values. The caller also specifies the name of the trustee.

Syntax

void BuildTrusteeWithObjectsAndNameA(
  PTRUSTEE_A          pTrustee,
  POBJECTS_AND_NAME_A pObjName,
  SE_OBJECT_TYPE      ObjectType,
  LPSTR               ObjectTypeName,
  LPSTR               InheritedObjectTypeName,
  LPSTR               Name
);

Parameters

pTrustee

A pointer to a TRUSTEE structure that will be initialized by this function. If the value of this parameter is NULL or a pointer that is not valid, the results are undefined.

pObjName

A pointer to an OBJECTS_AND_NAME structure that contains information about the trustee and the securable object.

ObjectType

A pointer to an SE_OBJECT_TYPE enumeration that contains information about the type of securable object.

ObjectTypeName

A pointer to a string that specifies the name that corresponds to the ObjectType GUID to be added to the TRUSTEE structure returned in the pTrustee parameter. This function determines the ObjectType GUID that corresponds to this name.

InheritedObjectTypeName

A pointer to a string that specifies the name that corresponds to the InheritedObjectType GUID to be added to the TRUSTEE structure returned in the pTrustee parameter. This function determines the InheritedObjectType GUID that corresponds to this name.

Name

A pointer to a string that specifies the name used to identify the trustee.

Return value

This function does not return a value.

Remarks

This function does not allocate memory for the TRUSTEE and OBJECTS_AND_NAME structures.

For more information about object-specific ACEs, see Object-specific ACEs.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header aclapi.h
Library Advapi32.lib
DLL Advapi32.dll

See also

Access Control

Basic Access Control Functions

BuildTrusteeWithName

BuildTrusteeWithObjectsAndSid

BuildTrusteeWithSid

OBJECTS_AND_NAME

Object-specific ACEs

SE_OBJECT_TYPE

TRUSTEE