Windows Dev Center

Expand Minimize

BuildTrusteeWithObjectsAndSid function

The BuildTrusteeWithObjectsAndSid 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 SID structure that represents the security identifier of the trustee.

Syntax


void WINAPI BuildTrusteeWithObjectsAndSid(
  _Inout_  PTRUSTEE         pTrustee,
  _In_opt_ POBJECTS_AND_SID pObjSid,
  _In_opt_ GUID             *pObjectGuid,
  _In_opt_ GUID             *pInheritedObjectGuid,
  _In_opt_ PSID             pSid
);

Parameters

pTrustee [in, out]

A pointer to a TRUSTEE structure to initialize. The BuildTrusteeWithObjectsAndSid function does not allocate any memory. If this parameter is NULL or a pointer that is not valid, the results are undefined.

pObjSid [in, optional]

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

pObjectGuid [in, optional]

A pointer to a GUID structure that describes the ObjectType GUID to be added to the TRUSTEE structure.

pInheritedObjectGuid [in, optional]

A pointer to a GUID structure that describes the InheritedObjectType GUID to be added to the TRUSTEE structure.

pSid [in, optional]

A pointer to a SID structure that identifies the trustee.

Return value

This function does not return a value.

Remarks

This function does not allocate memory for the TRUSTEE and OBJECTS_AND_SID 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]

Header

Aclapi.h

Library

Advapi32.lib

DLL

Advapi32.dll

Unicode and ANSI names

BuildTrusteeWithObjectsAndSidW (Unicode) and BuildTrusteeWithObjectsAndSidA (ANSI)

See also

Access Control
Object-specific ACEs
Basic Access Control Functions
BuildTrusteeWithName
BuildTrusteeWithObjectsAndName
BuildTrusteeWithSid
OBJECTS_AND_NAME
SE_OBJECT_TYPE
SID
TRUSTEE

 

 

Community Additions

ADD
Show:
© 2015 Microsoft