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 |
|
|
Library |
|
|
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