estrutura SI_ACCESS (aclui.h)

  • Artigo

A estrutura SI_ACCESS contém informações sobre um direito de acesso ou uma máscara de acesso padrão para um objeto protegível. O método ISecurityInformation::GetAccessRights usa essa estrutura para especificar informações que o editor de controle de acesso usa para inicializar suas páginas de propriedades.

Sintaxe

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

Membros

pguid

Um ponteiro para uma estrutura GUID que identifica o tipo de objeto ao qual a máscara de acesso à direita de acesso ou padrão se aplica. O GUID pode identificar um conjunto de propriedades ou uma propriedade no objeto ou um tipo de objeto filho que pode ser contido pelo objeto .

Se esse membro apontar para GUID_NULL, o direito de acesso se aplicará ao próprio objeto.

mask

Uma máscara de bits que especifica o direito de acesso descrito por essa estrutura. A máscara pode conter qualquer combinação de direitos padrão e específicos, mas não deve conter direitos genéricos, como GENERIC_ALL.

pszName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém uma cadeia de caracteres de exibição que descreve o direito de acesso.

Como alternativa, pszName pode ser um identificador de recurso de cadeia de caracteres retornado pela macro MAKEINTRESOURCE . Use o método ISecurityInformation::GetObjectInformation para identificar o módulo que contém o recurso de cadeia de caracteres.

dwFlags

Um conjunto de sinalizadores de bits que indicam onde o direito de acesso é exibido. Esse membro pode ser uma combinação do seguinte.

Valor Significado
SI_ACCESS_SPECIFIC
 O direito de acesso é exibido nas páginas de segurança avançadas.
SI_ACCESS_GENERAL
 O direito de acesso é exibido na página de segurança básica.
SI_ACCESS_CONTAINER
 Indica um direito de acesso que se aplica somente a contêineres. Se esse sinalizador estiver definido, o direito de acesso será exibido na página de segurança básica somente se o método ISecurityInformation::GetObjectInformation especificar o sinalizador SI_CONTAINER.
SI_ACCESS_PROPERTY
 Indica um direito de acesso específico à propriedade. Usado com SI_EDIT_PROPERTIES.
 

Esse membro também pode especificar uma combinação dos sinalizadores a seguir para indicar se outros contêineres ou objetos podem herdar o direito de acesso.

Valor Significado
CONTAINER_INHERIT_ACE
 Outros contêineres contidos pelo objeto primário herdam a entrada.
INHERIT_ONLY_ACE
 O ACE não se aplica ao objeto primário ao qual a ACL está anexada, mas os objetos contidos pelo objeto primário herdam a entrada.
OBJECT_INHERIT_ACE
 Objetos não pertencentes ao objeto primário herdam a entrada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho aclui.h

Confira também

GUID

ISecurityInformation::GetAccessRights

ISecurityInformation::GetObjectInformation