Función BuildTrusteeWithObjectsAndNameW (aclapi.h)

Artículo
08/22/2023

La función BuildTrusteeWithObjectsAndName inicializa una estructura TRUSTEE con la información de entrada de control de acceso (ACE) específica del objeto e inicializa los miembros restantes de la estructura en valores predeterminados. El autor de la llamada también especifica el nombre del administrador de confianza.

Sintaxis

void BuildTrusteeWithObjectsAndNameW(
  [in, out]      PTRUSTEE_W          pTrustee,
  [in, optional] POBJECTS_AND_NAME_W pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPWSTR              ObjectTypeName,
  [in, optional] LPWSTR              InheritedObjectTypeName,
  [in, optional] LPWSTR              Name
);

Parámetros

[in, out] pTrustee

Puntero a una estructura TRUSTEE que esta función inicializará. Si el valor de este parámetro es NULL o un puntero que no es válido, los resultados no están definidos.

[in, optional] pObjName

Puntero a una estructura OBJECTS_AND_NAME que contiene información sobre el administrador de confianza y el objeto protegible.

[in, optional] ObjectType

Puntero a una enumeración SE_OBJECT_TYPE que contiene información sobre el tipo de objeto protegible.

[in, optional] ObjectTypeName

Puntero a una cadena que especifica el nombre que corresponde al GUID objectType que se va a agregar a la estructura TRUSTEE devuelta en el parámetro pTrustee . Esta función determina el GUID objectType que corresponde a este nombre.

[in, optional] InheritedObjectTypeName

Puntero a una cadena que especifica el nombre que corresponde al GUID InheritedObjectType que se va a agregar a la estructura TRUSTEE devuelta en el parámetro pTrustee . Esta función determina el GUID InheritedObjectType que corresponde a este nombre.

[in, optional] Name

Puntero a una cadena que especifica el nombre usado para identificar al administrador de confianza.

Valor devuelto

None

Observaciones

Esta función no asigna memoria para las estructuras DE CONFIANZA y OBJECTS_AND_NAME .

Para obtener más información sobre las ACE específicas de objetos, vea ACE específicas del objeto.

Nota

El encabezado aclapi.h define BuildTrusteeWithObjectsAndName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	aclapi.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll