Função GetEnhMetaFileDescriptionA (wingdi.h)

A função GetEnhMetaFileDescription recupera uma descrição de texto opcional de um metarquivo de formato aprimorado e copia a cadeia de caracteres para o buffer especificado.

Sintaxe

UINT GetEnhMetaFileDescriptionA(
  [in]  HENHMETAFILE hemf,
  [in]  UINT         cchBuffer,
  [out] LPSTR        lpDescription
);

Parâmetros

[in] hemf

Um identificador para o metarquivo aprimorado.

[in] cchBuffer

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

[out] lpDescription

Um ponteiro para um buffer que recebe a descrição do texto opcional.

Valor retornado

Se a descrição do texto opcional existir e o ponteiro de buffer for NULL, o valor retornado será o comprimento da cadeia de caracteres de texto, em caracteres.

Se a descrição do texto opcional existir e o ponteiro de buffer for um ponteiro válido, o valor retornado será o número de caracteres copiados para o buffer.

Se a descrição do texto opcional não existir, o valor retornado será zero.

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

Comentários

A descrição de texto opcional contém duas cadeias de caracteres, a primeira identificando o aplicativo que criou o metarquivo aprimorado e a segunda identificando a imagem contida no metarquivo. As cadeias de caracteres são separadas por um caractere nulo e terminadas com dois caracteres nulos, por exemplo, "Editor de Gráficos XYZ\0Bald Eagle\0\0" em que \0 representa o caractere nulo.

Quando os argumentos de texto devem usar caracteres Unicode, use essa função como uma função de caractere largo. Quando os argumentos de texto devem usar caracteres do conjunto de caracteres do Windows, use essa função como uma função ANSI.

Observação

O cabeçalho wingdi.h define GetEnhMetaFileDescription como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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

Confira também

CreateEnhMetaFile

Funções de metafile

Visão geral dos metafiles