Compartilhar via


Função GetMetaFileA (wingdi.h)

[GetMetaFile não está mais disponível para uso a partir do Windows 2000. Em vez disso, use GetEnhMetaFile.]

A função GetMetaFile cria um identificador que identifica o metafile armazenado no arquivo especificado.

Sintaxe

HMETAFILE GetMetaFileA(
  [in] LPCSTR lpName
);

Parâmetros

[in] lpName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome de um metafile.

Valor de retorno

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

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

Observações

Essa função não é implementada na API Win32. Ele é fornecido para compatibilidade com versões de 16 bits do Windows. Em aplicativos Win32, use a função GetEnhMetaFile.

Nota

O cabeçalho wingdi.h define GetMetaFile 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
da Plataforma de Destino Windows
cabeçalho wingdi.h (inclua Windows.h)
biblioteca Gdi32.lib
de DLL Gdi32.dll

Consulte também

GetEnhMetaFile