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 meta-arquivo 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 metarquivo.

Retornar valor

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

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

Comentários

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

Observação

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 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

Requisito Valor
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

GetEnhMetaFile