Función BuildTrusteeWithObjectsAndSidA (aclapi.h)

Artículo
11/20/2024

La función BuildTrusteeWithObjectsAndSid inicializa una estructura de TRUSTEE con la información de entrada de control de acceso específica del objeto (ACE) e inicializa los miembros restantes de la estructura en valores predeterminados. El autor de la llamada también especifica la estructura 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 de 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 OBJECTS_AND_SID que contiene información sobre el administrador de confianza y el objeto protegible.

[in, optional] pObjectGuid

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

[in, optional] pInheritedObjectGuid

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

[in, optional] pSid

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

Valor devuelto

Ninguno

Observaciones

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

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 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	aclapi.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll