Compartilhar via


Função CopyMetaFileW (wingdi.h)

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

Observação Essa função é fornecida apenas para compatibilidade com metafilos no formato Windows. Os metafilos de formato aprimorado fornecem uma funcionalidade superior e são recomendados para novos aplicativos. A função correspondente para um metafile de formato aprimorado é CopyEnhMetaFile.
 

Sintaxe

HMETAFILE CopyMetaFileW(
  [in] HMETAFILE unnamedParam1,
  [in] LPCWSTR   unnamedParam2
);

Parâmetros

[in] unnamedParam1

Um identificador para o metafile de formato windows de origem.

[in] unnamedParam2

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

Valor de retorno

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

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

Observações

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.

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

Nota

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

DeleteMetaFile

Funções de metafile

Visão geral de metafiles