Método IEffectivePermission::GetEffectivePermission (aclui.h)

O método GetEffectivePermission retorna a permissão efetiva para um tipo de objeto.

Sintaxe

HRESULT GetEffectivePermission(
  [in]  const GUID           *pguidObjectType,
  [in]  PSID                 pUserSid,
  [in]  LPCWSTR              pszServerName,
  [in]  PSECURITY_DESCRIPTOR pSD,
  [out] POBJECT_TYPE_LIST    *ppObjectTypeList,
  [out] ULONG                *pcObjectTypeListLength,
  [out] PACCESS_MASK         *ppGrantedAccessList,
  [out] ULONG                *pcGrantedAccessListLength
);

Parâmetros

[in] pguidObjectType

Um GUID para o tipo de objeto cuja permissão está sendo consultada.

[in] pUserSid

Um ponteiro para uma estrutura SID que representa a entidade de segurança cuja permissão efetiva está sendo determinada.

[in] pszServerName

Um ponteiro para a cadeia de caracteres largos terminada em nulo que representa o nome do servidor.

[in] pSD

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que representa o descritor de segurança do objeto. O descritor de segurança é usado para executar a marcar de acesso.

[out] ppObjectTypeList

Um ponteiro para um ponteiro para uma estrutura OBJECT_TYPE_LIST que representa a matriz de tipos de objeto na árvore de objetos do objeto. Se um objeto não der suporte ao acesso à propriedade, use a técnica a seguir para especificar o valor do OBJECT_TYPE_LIST.

#include <windows.h>

OBJECT_TYPE_LIST g_DefaultOTL[] = {
 {0, 0, (LPGUID)&GUID_NULL},
};

[out] pcObjectTypeListLength

Um ponteiro para um ULONG que recebe a contagem de tipos de objeto apontados por ppObjectTypeList.

[out] ppGrantedAccessList

Um ponteiro para um ponteiro para um ACCESS_MASK que recebe a matriz de máscaras de acesso concedidas. O sistema operacional usará LocalFree para liberar a memória alocada para esse parâmetro.

[out] pcGrantedAccessListLength

Um ponteiro para uma variável ULONG que recebe a contagem de máscaras de acesso concedidas apontadas pelo parâmetro ppGrantedAccessList .

Retornar valor

Se a função for bem-sucedida, o valor retornado será S_OK.

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

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