Compartilhar via

Método IAccessControl::GrantAccessRights (iaccess.h)

  • Artigo

Mescla a nova lista de direitos de acesso com os direitos de acesso existentes no objeto .

Sintaxe

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

Parâmetros

[in] pAccessList

Um ponteiro para a estrutura ACTRL_ACCESS que contém uma matriz de listas de acesso para o objeto.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Mesclar a nova lista de direitos de acesso com os direitos de acesso existentes garante que o objeto terá pelo menos os direitos de acesso indicados. Esse processo de mesclagem consiste em adicionar os novos direitos de acesso negados antes dos antigos direitos de acesso negados e os novos direitos de acesso permitidos antes dos direitos permitidos existentes. Nenhum dos direitos existentes é removido.

Após uma mesclagem, os direitos de acesso em um objeto são ordenados da seguinte maneira:

  1. [Novo acesso negado]
  2. [Acesso antigo negado]
  3. [Novo acesso permitido]
  4. [Acesso antigo permitido]
A implementação fornecida pelo sistema de [ACTRL_ACCESS](.. A estrutura /accctrl/ns-accctrl-explicit_access_a.md) será definida como 1. Além disso, o membro lpProperty da estrutura ACTRL_PROPERTY_ENTRYW deve ser NULL para indicar que a lista de entradas de acesso se aplica ao próprio objeto.

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]
Plataforma de Destino Windows
Cabeçalho iaccess.h

Confira também

Iaccesscontrol