Función AddScopedPolicyIDAce (securitybaseapi.h)
La función AddScopedPolicyIDAce agrega una entrada de control de acceso (ACE) SYSTEM_SCOPED_POLICY_ID_ACE al final de una lista de control de acceso del sistema (SACL). Una estructura de SYSTEM_SCOPED_POLICY_ID_ACE especifica una directiva de acceso central (CAP) que se asociará al recurso y se puede usar durante las comprobaciones de acceso. El conjunto de derechos de acceso estándar se define en el tema Derechos de acceso estándar .
Sintaxis
BOOL AddScopedPolicyIDAce(
[in, out] PACL pAcl,
[in] DWORD dwAceRevision,
[in] DWORD AceFlags,
[in] DWORD AccessMask,
[in] PSID pSid
);
Parámetros
[in, out] pAcl
Puntero a una lista de control de acceso (ACL). Esta función agrega una ACE a esta ACL. El valor de este parámetro no puede ser NULL.
[in] dwAceRevision
Especifica el nivel de revisión de la ACL que se va a modificar. Este valor puede ser ACL_REVISION o ACL_REVISION_DS. Use ACL_REVISION_DS si la ACL contiene ACE específicas del objeto.
[in] AceFlags
Un conjunto de marcas de bits que controlan la herencia ACE. La función establece estas marcas en el miembro AceFlags de la estructura ACE_HEADER de la nueva ACE.
Para mantener la coherencia con la interfaz de usuario de permisos de archivo avanzados de Windows 8, las aplicaciones deben especificar las marcas CONTAINER_INHERIT_ACE y OBJECT_INHERIT_ACE en el parámetro AceFlags.
Este parámetro puede ser una combinación de los valores siguientes.
[in] AccessMask
Debe ser cero para Windows 8 y Windows Server 2012.
[in] pSid
Puntero al SID (S-1-17-*) que identifica la directiva de acceso central que se va a asociar al recurso.
Valor devuelto
Si la función se ejecuta correctamente, devuelve TRUE.
Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | securitybaseapi.h (incluya Windows.h) |
Library | Kernel32.lib |
Archivo DLL | Kernel32.dll |
Vea también
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