estrutura ACTRL_ACCESS_ENTRYA (accctrl.h)

  • Artigo

Contém informações de controle de acesso para um objeto de confiança especificado. Essa estrutura armazena informações equivalentes às informações de controle de acesso armazenadas em uma ACE.

Sintaxe

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

Membros

Trustee

Uma estrutura TRUSTEE que identifica o usuário, o grupo ou o programa (como um serviço) ao qual a entrada de controle de acesso se aplica.

fAccessFlags

Indica como os direitos de acesso especificados pelos membros Access e ProvSpecificAccess se aplicam ao objeto de confiança. Esse membro pode ser um dos valores a seguir. Se você estiver usando essa estrutura com a implementação COM de IAccessControl, esse membro deverá ser ACTRL_ACCESS_ALLOWED ou ACTRL_ACCESS_DENIED.

Valor Significado
ACTRL_ACCESS_ALLOWED
0x00000001
 Os direitos são permitidos.
ACTRL_ACCESS_DENIED
0x00000002
 Os direitos são negados.
ACTRL_AUDIT_SUCCESS
0x00000004
 O sistema gera mensagens de auditoria para tentativas com falha de usar os direitos.
ACTRL_AUDIT_FAILURE
0x00000008
 O sistema gera mensagens de auditoria para tentativas bem-sucedidas de usar os direitos.

Access

Uma máscara de bits que especifica os direitos de acesso que a entrada permite, nega ou audita para o administrador.

Esse membro deve usar os sinalizadores de acesso independentes do provedor, como ACTRL_READ_CONTROL, em vez de sinalizadores de acesso, como READ_CONTROL. O provedor para o tipo de objeto converte esses sinalizadores independentes do provedor para os sinalizadores específicos do provedor correspondentes.

Se você estiver usando essa estrutura com a implementação COM de IAccessControl, esse membro deverá ser COM_RIGHTS_EXECUTE.

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

Uma máscara de bits que especifica direitos de acesso específicos ao tipo de provedor. As funções que usam a estrutura ACTRL_ACCESS_ENTRY passam esses bits para o provedor sem interpretá-los. Na maioria dos casos, esse membro deve ser 0.

Inheritance

Um conjunto de sinalizadores de bits que determina se outros contêineres ou objetos podem herdar a entrada de controle de acesso do objeto primário ao qual a lista de acesso está anexada. Se você estiver usando essa estrutura com a implementação COM de IAccessControl, esse valor deverá ser NO_INHERITANCE, o que indica que a entrada de controle de acesso não é herdável. Caso contrário, esse valor pode ser NO_INHERITANCE ou pode ser uma combinação dos valores a seguir.

Valor Significado
CONTAINER_INHERIT_ACE
0x2
 Outros contêineres contidos pelo objeto primário herdam a entrada.
INHERIT_ONLY_ACE
0x8
 A 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.
NO_PROPAGATE_INHERIT_ACE
0x4
 Os sinalizadores OBJECT_INHERIT_ACE e CONTAINER_INHERIT_ACE não são propagados para uma entrada herdada.
OBJECT_INHERIT_ACE
0x1
 Objetos não pertencentes ao contêiner contidos pelo objeto primário herdam a entrada.
SUB_CONTAINERS_AND_OBJECTS_INHERIT
0x3
 Contêineres e objetos não pertencentes a contêineres contidos pelo objeto primário herdam a entrada. Esse sinalizador corresponde à combinação dos sinalizadores CONTAINER_INHERIT_ACE e OBJECT_INHERIT_ACE.
SUB_CONTAINERS_ONLY_INHERIT
0x2
 Outros contêineres contidos pelo objeto primário herdam a entrada. Esse sinalizador corresponde ao sinalizador CONTAINER_INHERIT_ACE.
SUB_OBJECTS_ONLY_INHERIT
0x1
 Objetos não pertencentes ao contêiner contidos pelo objeto primário herdam a entrada. Esse sinalizador corresponde ao sinalizador OBJECT_INHERIT_ACE.

lpInheritProperty

Um ponteiro para uma cadeia de caracteres terminada em nulo que identifica os tipos de objeto que podem herdar a entrada. Se você estiver usando essa estrutura com a implementação COM de IAccessControl, esse membro deverá ser NULL.

Comentários

Observação

O cabeçalho accctrl.h define ACTRL_ACCESS_ENTRY como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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

Confira também

ACTRL_ACCESS_ENTRY_LIST

ADMINISTRADOR