Compartilhar via

estrutura ACTRL_ACCESS_ENTRYW (accctrl.h)

  • Artigo

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

Sintaxe

typedef struct _ACTRL_ACCESS_ENTRYW {
  TRUSTEE_W     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPWSTR        lpInheritProperty;
} ACTRL_ACCESS_ENTRYW, *PACTRL_ACCESS_ENTRYW;

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 administrador. 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 ao 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
 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.
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 objeto primário herdam a entrada.
SUB_CONTAINERS_AND_OBJECTS_INHERIT
0x3
 Os contêineres e os objetos não pertencentes ao 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 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 de 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