Função GetEnhMetaFileA (wingdi.h)
A função GetEnhMetaFile cria um identificador que identifica o metafile 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 metafile aprimorado.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será um identificador para o metafile aprimorado.
Se a função falhar, o valor retornado será NULL.
Observações
Quando o aplicativo não precisar mais de um identificador de metafile aprimorado, ele deverá excluir o identificador chamando a função DeleteEnhMetaFile.
Um metafile no formato Windows deve ser convertido no formato aprimorado antes de ser processado pela função GetEnhMetaFile
Em que argumentos de texto devem usar caracteres Unicode, use essa função como uma função de caractere largo. Em que 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 metafile aprimorado e exibindo seu conteúdo.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | wingdi.h (inclua Windows.h) |
| biblioteca | Gdi32.lib |
| de DLL |
Gdi32.dll |
Consulte também
DeleteEnhMetaFile
SetWinMetaFileBits