Função CopyEnhMetaFileA (wingdi.h)

A função CopyEnhMetaFile copia o conteúdo de um metarquivo de formato aprimorado para um arquivo especificado.

Sintaxe

HENHMETAFILE CopyEnhMetaFileA(
  [in] HENHMETAFILE hEnh,
  [in] LPCSTR       lpFileName
);

Parâmetros

[in] hEnh

Um identificador para o meta-arquivo aprimorado a ser copiado.

[in] lpFileName

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

Valor retornado

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

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

Comentários

Quando os argumentos de texto devem usar caracteres Unicode, use a função CopyEnhMetaFile 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.

Os aplicativos podem usar meta-arquivos armazenados na memória para operações temporárias.

Quando o aplicativo não precisar mais do identificador enhanced-metafile, ele deverá excluir o identificador chamando a função DeleteEnhMetaFile .

Observação

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

Confira também

Deleteenhmetafile

Funções de metafile

Visão geral dos metafiles