SI_ACCESS estructura (aclui.h)

Artículo
02/26/2024

La estructura SI_ACCESS contiene información sobre un derecho de acceso o una máscara de acceso predeterminada para un objeto protegible. El método ISecurityInformation::GetAccessRights usa esta estructura para especificar información que el editor de control de acceso usa para inicializar sus páginas de propiedades.

Sintaxis

typedef struct _SI_ACCESS {
  const GUID  *pguid;
  ACCESS_MASK mask;
  LPCWSTR     pszName;
  DWORD       dwFlags;
} SI_ACCESS, *PSI_ACCESS;

Miembros

pguid

Puntero a una estructura GUID que identifica el tipo de objeto al que se aplica el derecho de acceso o la máscara de acceso predeterminada. El GUID puede identificar un conjunto de propiedades o una propiedad en el objeto, o un tipo de objeto secundario que el objeto puede contener.

Si este miembro apunta a GUID_NULL, el derecho de acceso se aplica al propio objeto.

mask

Máscara de bits que especifica el derecho de acceso descrito por esta estructura. La máscara puede contener cualquier combinación de derechos estándar y específicos, pero no debe contener derechos genéricos como GENERIC_ALL.

pszName

Puntero a una cadena Unicode terminada en null que contiene una cadena de visualización que describe el derecho de acceso.

Como alternativa, pszName puede ser un identificador de recurso de cadena devuelto por la macro MAKEINTRESOURCE . Use el método ISecurityInformation::GetObjectInformation para identificar el módulo que contiene el recurso de cadena.

dwFlags

Conjunto de marcas de bits que indican dónde se muestra el derecho de acceso. Este miembro puede ser una combinación de lo siguiente.

Valor	Significado
SI_ACCESS_SPECIFIC	El derecho de acceso se muestra en las páginas de seguridad avanzada.
SI_ACCESS_GENERAL	El derecho de acceso se muestra en la página de seguridad básica.
SI_ACCESS_CONTAINER	Indica un derecho de acceso que solo se aplica a los contenedores. Si se establece esta marca, el derecho de acceso se muestra en la página de seguridad básica solo si el método ISecurityInformation::GetObjectInformation especifica la marca SI_CONTAINER.
SI_ACCESS_PROPERTY	Indica un derecho de acceso específico de la propiedad. Se usa con SI_EDIT_PROPERTIES.

Este miembro también puede especificar una combinación de las marcas siguientes para indicar si otros contenedores u objetos pueden heredar el derecho de acceso.

Valor	Significado
CONTAINER_INHERIT_ACE	Otros contenedores contenidos en el objeto principal heredan la entrada.
INHERIT_ONLY_ACE	La ACE no se aplica al objeto principal al que se adjunta la ACL, pero los objetos contenidos en el objeto principal heredan la entrada.
OBJECT_INHERIT_ACE	Los objetos no contenidos en el objeto principal heredan la entrada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	aclui.h

Consulte también

GUID

ISecurityInformation::GetAccessRights

ISecurityInformation::GetObjectInformation