Função GetEnhMetaFileBits (wingdi.h)

Artigo
08/27/2023

A função GetEnhMetaFileBits recupera o conteúdo do metarquivo de formato aprimorado especificado e os copia em um buffer.

Sintaxe

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

Parâmetros

[in] hEMF

Um identificador para o metarquivo aprimorado.

[in] nSize

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

[out] lpData

Um ponteiro para um buffer que recebe os dados de metarquivo. O buffer deve ser suficientemente grande para conter os dados. Se lpbBuffer for NULL, a função retornará o tamanho necessário para manter os dados.

Valor retornado

Se a função for bem-sucedida e o ponteiro de buffer for NULL, o valor retornado será o tamanho do metafile aprimorado, em bytes.

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

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

Comentários

Depois que os bits de metafile aprimorados forem recuperados, eles poderão ser usados para criar um metafile baseado em memória chamando a função SetEnhMetaFileBits .

A função GetEnhMetaFileBits não invalida o identificador enhanced-metafile. O aplicativo deve chamar a função DeleteEnhMetaFile para excluir o identificador quando ele não for mais necessário.

O conteúdo do metarquivo recuperado por essa função está no formato aprimorado. Para recuperar o conteúdo do metarquivo no formato Windows, use a função GetWinMetaFileBits .

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