Método ISecurityInformation::GetAccessRights (aclui.h)

Artigo
02/28/2024

O método GetAccessRights solicita informações sobre os direitos de acesso que podem ser controlados para um objeto protegível. O editor de controle de acesso chama esse método para recuperar cadeias de caracteres de exibição e outras informações usadas para inicializar as páginas de propriedades. Para obter mais informações, consulte Direitos de Acesso e Máscaras de Acesso.

Sintaxe

HRESULT GetAccessRights(
  [in]  const GUID *pguidObjectType,
  [in]  DWORD      dwFlags,
  [out] PSI_ACCESS *ppAccess,
  [out] ULONG      *pcAccesses,
  [out] ULONG      *piDefaultAccess
);

Parâmetros

[in] pguidObjectType

Um ponteiro para uma estrutura GUID que identifica o tipo de objeto para o qual os direitos de acesso estão sendo solicitados. Se esse parâmetro for NULL ou um ponteiro para GUID_NULL, retorne os direitos de acesso para o objeto que está sendo editado. Caso contrário, o GUID identifica um tipo de objeto filho retornado pelo método ISecurityInformation::GetInheritTypes . O GUID corresponde ao membro InheritedObjectType de uma ACE específica do objeto.

[in] dwFlags

Um conjunto de sinalizadores de bits que indicam a página de propriedades que está sendo inicializada. Esse valor será zero se a página de segurança básica estiver sendo inicializada. Caso contrário, será uma combinação dos valores a seguir.

Valor	Significado
SI_ADVANCED	A folha de propriedades Segurança Avançada está sendo inicializada.
SI_EDIT_AUDITS	A folha de propriedades Segurança Avançada inclui a página de propriedades Auditoria .
SI_EDIT_PROPERTIES	A folha de propriedades Segurança Avançada permite a edição de ACEs que se aplicam às propriedades e aos conjuntos de propriedades do objeto.

[out] ppAccess

Um ponteiro para uma matriz de estruturas SI_ACCESS . A matriz deve incluir uma entrada para cada direito de acesso. Você pode especificar direitos de acesso que se aplicam ao próprio objeto, bem como direitos de acesso específicos ao objeto que se aplicam somente a um conjunto de propriedades ou propriedade no objeto.

[out] pcAccesses

Um ponteiro para ULONG que indica o número de entradas na matriz ppAccess .

[out] piDefaultAccess

Um ponteiro para ULONG que indica o índice baseado em zero da entrada de matriz que contém os direitos de acesso padrão. O editor de controle de acesso usa essa entrada como os direitos de acesso iniciais em uma nova ACE.

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

O método GetAccessRights é chamado sempre que uma página de propriedades é inicializada.

O editor de controle de acesso não libera o ponteiro retornado em ppAccess.

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