Función BuildTrusteeWithObjectsAndSidA (aclapi.h)

Artículo
03/05/2024

La función BuildTrusteeWithObjectsAndSid 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 la estructura del SID que representa el identificador de seguridad del administrador de confianza.

Sintaxis

void BuildTrusteeWithObjectsAndSidA(
  [in, out]      PTRUSTEE_A       pTrustee,
  [in, optional] POBJECTS_AND_SID pObjSid,
  [in, optional] GUID             *pObjectGuid,
  [in, optional] GUID             *pInheritedObjectGuid,
  [in, optional] PSID             pSid
);

Parámetros

[in, out] pTrustee

Puntero a una estructura TRUSTEE que se va a inicializar. La función BuildTrusteeWithObjectsAndSid no asigna ninguna memoria. Si este parámetro es NULL o un puntero que no es válido, los resultados no están definidos.

[in, optional] pObjSid

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

[in, optional] pObjectGuid

Puntero a una estructura GUID que describe el GUID objectType que se va a agregar a la estructura TRUSTEE .

[in, optional] pInheritedObjectGuid

Puntero a una estructura GUID que describe el GUID InheritedObjectType que se va a agregar a la estructura TRUSTEE .

[in, optional] pSid

Puntero a una estructura de SID que identifica al administrador de confianza.

Valor devuelto

None

Observaciones

Esta función no asigna memoria para las estructuras TRUSTEE y OBJECTS_AND_SID .

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

Nota

El encabezado aclapi.h define BuildTrusteeWithObjectsAndSid 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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