Função GetEnhMetaFileA (wingdi.h)

Artigo
08/27/2023

A função GetEnhMetaFile cria um identificador que identifica o meta-arquivo de formato aprimorado armazenado no arquivo especificado.

Sintaxe

HENHMETAFILE GetEnhMetaFileA(
  [in] LPCSTR lpName
);

Parâmetros

[in] lpName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome de um meta-arquivo aprimorado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador para o meta-arquivo aprimorado.

Se a função falhar, o valor retornado será NULL.

Comentários

Quando o aplicativo não precisar mais de um identificador de meta-arquivo aprimorado, ele deverá excluir o identificador chamando a função DeleteEnhMetaFile .

Um metarquivo no formato windows deve ser convertido no formato aprimorado antes de ser processado pela função GetEnhMetaFile . Para converter o arquivo, use a função SetWinMetaFileBits .

Quando os argumentos de texto devem usar caracteres Unicode, use essa função como uma função de caractere largo. Quando os argumentos de texto devem usar caracteres do conjunto de caracteres do Windows, use essa função como uma função ANSI.

Exemplos

Para obter um exemplo, consulte Abrindo um metarquivo aprimorado e exibindo seu conteúdo.

Observação

O cabeçalho wingdi.h define GetEnhMetaFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos


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