Função GetMetaFileBitsEx (wingdi.h)

Artigo
03/04/2024

A função GetMetaFileBitsEx recupera o conteúdo de um metarquivo no formato windows e copia-os para o buffer 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 é GetEnhMetaFileBits.

Sintaxe

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

Parâmetros

[in] hMF

Um identificador para um metarquivo no formato do Windows.

[in] cbBuffer

O tamanho, em bytes, do buffer para receber os dados.

[out] lpData

Um ponteiro para um buffer que recebe os dados de meta-arquivo. O buffer deve ser suficientemente grande para conter os dados. Se lpvData for NULL, a função retornará o número de bytes necessários para manter os dados.

Retornar valor

Se a função for bem-sucedida e o ponteiro do buffer for NULL, o valor retornado será o número de bytes necessários para o buffer; se a função for bem-sucedida e o ponteiro do buffer for um ponteiro válido, o valor retornado será o número de bytes copiados.

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

Comentários

Depois que os bits de meta-arquivo do Windows forem recuperados, eles poderão ser usados para criar um meta-arquivo baseado em memória chamando a função SetMetaFileBitsEx .

A função GetMetaFileBitsEx não invalida o identificador de meta-arquivo. Um aplicativo deve excluir esse identificador chamando a função DeleteMetaFile .

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

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