Função MapGenericMask (securitybaseapi.h)

Artigo
03/13/2024

A função MapGenericMask mapeia os direitos de acesso genéricos em uma máscara de acesso para direitos de acesso específicos e padrão. A função aplica um mapeamento fornecido em uma estrutura GENERIC_MAPPING .

Sintaxe

void MapGenericMask(
  [in, out] PDWORD           AccessMask,
  [in]      PGENERIC_MAPPING GenericMapping
);

Parâmetros

[in, out] AccessMask

Um ponteiro para uma máscara de acesso.

[in] GenericMapping

Um ponteiro para uma estrutura GENERIC_MAPPING especificando um mapeamento de tipos de acesso genéricos para tipos de acesso específicos e padrão.

Retornar valor

Nenhum

Comentários

Depois de chamar a função MapGenericMask , a máscara de acesso apontada pelo parâmetro AccessMask não tem nenhum de seus bits genéricos (GenericRead, GenericWrite, GenericExecute ou GenericAll) ou bits indefinidos definidos, embora possa ter outros bits definidos. Se bits diferentes dos bits genéricos forem fornecidos na entrada, essa função não os limpará.

Exemplos

Para obter um exemplo que usa essa função, consulte Verificando o acesso do cliente com ACLs.

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	securitybaseapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll