BuildTrusteeWithObjectsAndName

The BuildTrusteeWithObjectsAndName function initializes a TRUSTEE structure with the specified object-specific ACE information, initializing the remaining members of the structure to default values. The caller also specifies the name of the trustee.

VOID BuildTrusteeWithObjectsAndName(
  PTRUSTEE pTrustee,
  POBJECTS_AND_NAME pObjName,
  SE_OBJECT_TYPE ObjectType,
  LPSTR ObjectTypeName,
  LPSTR InheritedObjectTypeName,
  LPSTR Name
);

Parameters

pTrustee

[in/out] Pointer to a TRUSTEE structure that will be initialized by this function. If the value of this parameter is NULL, the function does nothing.

pObjName

[in] Pointer to an OBJECTS_AND_NAME structure that contains information about the trustee and the securable object.

ObjectType

[in] Pointer to an SE_OBJECT_TYPE structure that contains information about the type of securable object.

ObjectTypeName

[in] Pointer to a string that specifies the name corresponding to the ObjectType GUID to be added to the TRUSTEE structure returned in pTrustee. This function determines the ObjectType GUID corresponding to this name.

InheritedObjectTypeName

[in] Pointer to a string that specifies the name corresponding to the InheritedObjectType GUID to be added to the TRUSTEE structure returned in pTrustee. This function determines the InheritedObjectType GUID corresponding to this name.

Name

[in] Pointer to a string that specifies the name used to identify the trustee.

Return Values

This function does not return a value.

Remarks

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

For more information on object-specific ACEs, refer to Object-Specific ACEs.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Aclapi.h.
  Library: Use Advapi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows 2000.

See Also

Access Control Overview, Access Control Functions, BuildTrusteeWithName, BuildTrusteeWithSid, BuildTrusteeWithObjectsAndSid, TRUSTEE, OBJECTS_AND_NAME, SE_OBJECT_TYPE, Object-Specific ACEs