Export (0) Print
Expand All
Expand Minimize

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

Aclapi.h

Library

Advapi32.lib

DLL

Advapi32.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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft