Função CopyMetaFileA (wingdi.h)

A função CopyMetaFile copia o conteúdo de um metarquivo no formato windows para o arquivo especificado.

Nota Essa função é fornecida apenas para compatibilidade com metarquivos no formato Windows. Os meta-arquivos de formato aprimorado fornecem funcionalidade superior e são recomendados para novos aplicativos. A função correspondente para um metarquivo de formato aprimorado é CopyEnhMetaFile.
 

Sintaxe

HMETAFILE CopyMetaFileA(
  [in] HMETAFILE unnamedParam1,
  [in] LPCSTR    unnamedParam2
);

Parâmetros

[in] unnamedParam1

Um identificador para o metarquivo de formato do Windows de origem.

[in] unnamedParam2

Um ponteiro para o nome do arquivo de destino. Se esse parâmetro for NULL, o meta-arquivo de origem será copiado para a memória.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para a cópia do metarquivo de formato do Windows.

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

Comentários

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.

Quando o aplicativo não precisar mais do identificador de meta-arquivo no formato do Windows, ele deverá excluir o identificador chamando a função DeleteMetaFile .

Observação

O cabeçalho wingdi.h define CopyMetaFile 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
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

Confira também

Deletemetafile

Funções de metarquivo

Visão geral de meta-arquivos