Função SetMetaFileBitsEx (wingdi.h)

Artigo
03/13/2024

A função SetMetaFileBitsEx cria um metarquivo de formato windows baseado em memória dos dados fornecidos.

Nota Essa função é fornecida apenas para compatibilidade com metafiles 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 é SetEnhMetaFileBits.

Sintaxe

HMETAFILE SetMetaFileBitsEx(
  [in] UINT       cbBuffer,
  [in] const BYTE *lpData
);

Parâmetros

[in] cbBuffer

Especifica o tamanho, em bytes, do metarquivo no formato Windows.

[in] lpData

Ponteiro para um buffer que contém o metarquivo de formato do Windows. (Supõe-se que os dados foram obtidos usando a função GetMetaFileBitsEx .)

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para um metarquivo de formato windows baseado em memória.

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

Comentários

Para converter um metarquivo no formato windows em um metarquivo de formato aprimorado, use a função SetWinMetaFileBits .

Quando o aplicativo não precisar mais do identificador de metafile retornado por SetMetaFileBitsEx, ele deverá excluí-lo chamando a função DeleteMetaFile .

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