BuildTrusteeWithObjectsAndSid

The BuildTrusteeWithObjectsAndSid 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 SID of the trustee.

VOID BuildTrusteeWithObjectsAndSid(
  PTRUSTEE pTrustee,
  POBJECTS_AND_SID pObjSid,
  GUID *pObjectGuid,
  GUID *pInheritedObjectGuid,
  PSID pSid
);

Parameters

pTrustee

[in/out] Pointer to a TRUSTEE structure to initialize. The BuildTrusteeWithSid function does not allocate any memory. If this parameter is NULL, the function does nothing.

pObjSid

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

pObjectGuid

[in] Pointer to a GUID structure that describes the ObjectType GUID to be added to the TRUSTEE structure.

pInheritedObjectGuid

[in] Pointer to a GUID structure that describes the InheritedObjectType GUID to be added to the TRUSTEE structure.

pSid

[in] Pointer to a SID structure that identifies 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, BuildTrusteeWithObjectsAndName, BuildTrusteeWithSid, TRUSTEE, SID, OBJECTS_AND_NAME, SE_OBJECT_TYPE, Object-Specific ACEs