Función BuildTrusteeWithObjectsAndSidA (aclapi.h)
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 |
Consulte también
Funciones básicas de Access Control
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de