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

Artigo
02/26/2024

O método MapGeneric solicita que os direitos de acesso genéricos em uma máscara de acesso sejam mapeados para seus direitos de acesso padrão e específicos correspondentes. Para obter mais informações sobre direitos de acesso genéricos, padrão e específicos, consulte Direitos de Acesso e Máscaras de Acesso.

Sintaxe

HRESULT MapGeneric(
  [in] const GUID  *pguidObjectType,
  [in] UCHAR       *pAceFlags,
  [in] ACCESS_MASK *pMask
);

Parâmetros

[in] pguidObjectType

Um ponteiro para uma estrutura GUID que identifica o tipo de objeto ao qual a máscara de acesso se aplica. Se esse membro for NULL ou um ponteiro para GUID_NULL, a máscara de acesso se aplicará ao próprio objeto.

[in] pAceFlags

Um ponteiro para o membro AceFlags da estrutura ACE_HEADER do ACE cuja máscara de acesso está sendo mapeada.

[in] pMask

Um ponteiro para uma máscara de acesso que contém os direitos de acesso genéricos a serem mapeados. Sua implementação deve mapear os direitos de acesso genéricos para os direitos de acesso padrão e específicos correspondentes para o tipo de objeto especificado.

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

Sua implementação MapGeneric pode chamar a função MapGenericMask para mapear os direitos de acesso genéricos na máscara de acesso.

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