Compartilhar via

Função GetEnhMetaFileHeader (wingdi.h)

  • Artigo

A função GetEnhMetaFileHeader recupera o registro que contém o cabeçalho do metarquivo de formato aprimorado especificado.

Sintaxe

UINT GetEnhMetaFileHeader(
  [in]  HENHMETAFILE    hemf,
  [in]  UINT            nSize,
  [out] LPENHMETAHEADER lpEnhMetaHeader
);

Parâmetros

[in] hemf

Um identificador para o meta-arquivo aprimorado para o qual o cabeçalho deve ser recuperado.

[in] nSize

O tamanho, em bytes, do buffer para receber os dados. Somente esses muitos bytes serão copiados.

[out] lpEnhMetaHeader

Um ponteiro para uma estrutura ENHMETAHEADER que recebe o registro de cabeçalho. Se esse parâmetro for NULL, a função retornará o tamanho do registro de cabeçalho.

Retornar valor

Se a função for bem-sucedida e o ponteiro de estrutura for NULL, o valor retornado será o tamanho do registro que contém o cabeçalho; se o ponteiro de estrutura for um ponteiro válido, o valor retornado será o número de bytes copiados. Caso contrário, será zero.

Comentários

Um cabeçalho enhanced-metafile contém informações como o tamanho do metarquivo, em bytes; as dimensões da imagem armazenada no metarquivo; o número de registros armazenados no metarquivo; o deslocamento para a descrição de texto opcional; o tamanho da paleta opcional e a resolução do dispositivo no qual a imagem foi criada.

O registro que contém o cabeçalho enhanced-metafile é sempre o primeiro registro no metarquivo.

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

Confira também

ENHMETAHEADER

Funções de metarquivo

Visão geral de meta-arquivos

PlayEnhMetaFile