BuildTrusteeWithObjectsAndName 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 WINAPI BuildTrusteeWithObjectsAndName(
_Inout_ PTRUSTEE pTrustee,
_In_opt_ POBJECTS_AND_NAME pObjName,
_In_opt_ SE_OBJECT_TYPE ObjectType,
_In_opt_ LPTSTR ObjectTypeName,
_In_opt_ LPTSTR InheritedObjectTypeName,
_In_opt_ LPTSTR Name
);
Parameters
- pTrustee [in, out]
-
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 [in, optional]
-
A pointer to an OBJECTS_AND_NAME structure that contains information about the trustee and the securable object.
- ObjectType [in, optional]
-
A pointer to an SE_OBJECT_TYPE enumeration that contains information about the type of securable object.
- ObjectTypeName [in, optional]
-
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 [in, optional]
-
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 [in, optional]
-
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] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
BuildTrusteeWithObjectsAndNameW (Unicode) and BuildTrusteeWithObjectsAndNameA (ANSI) |
See also
- Access Control
- Object-specific ACEs
- Basic Access Control Functions
- BuildTrusteeWithName
- BuildTrusteeWithObjectsAndSid
- BuildTrusteeWithSid
- OBJECTS_AND_NAME
- SE_OBJECT_TYPE
- TRUSTEE