Compartilhar via


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

Obtém toda a lista de direitos de acesso e/ou o proprietário e o grupo do objeto especificado.

Sintaxe

HRESULT GetAllAccessRights(
  [in]  LPWSTR                            lpProperty,
  [out] PACTRL_ACCESSW_ALLOCATE_ALL_NODES *ppAccessList,
  [out] PTRUSTEEW                         *ppOwner,
  [out] PTRUSTEEW                         *ppGroup
);

Parâmetros

[in] lpProperty

O nome da propriedade. Se você estiver usando a implementação COM de IAccessControl, esse parâmetro deverá ser NULL.

[out] ppAccessList

O endereço da variável de ponteiro que recebe um ponteiro para a estrutura da lista de acesso. Esse parâmetro não pode ser ACTRL_ACCESS.

Se a chamada for bem-sucedida, o chamador deverá liberar a memória alocada com a função CoTaskMemFree . Observe que a memória é allocate(all_nodes), o que significa que todas as subestruturas são alocadas em um bloco. Portanto, toda a estrutura de dados deve ser liberada por uma única chamada para CoTaskMemFree.

[out] ppOwner

Um ponteiro para uma estrutura TRUSTEE que recebe as informações do proprietário. Se esse parâmetro não for NULL e a função for bem-sucedida, o chamador deverá liberar a memória com CoTaskMemFree.

[out] ppGroup

Um ponteiro para uma estrutura TRUSTEE que recebe as informações do grupo. Se esse parâmetro não for NULL e a função for bem-sucedida, o chamador deverá liberar a memória com CoTaskMemFree.

Retornar valor

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

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

ACTRL_ACCESS

Iaccesscontrol