Função GetFileVersionInfoA (winver.h)

Artigo
11/20/2024

Recupera informações de versão do arquivo especificado.

Sintaxe

BOOL GetFileVersionInfoA(
  [in]  LPCSTR lptstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Parâmetros

[in] lptstrFilename

Tipo: LPCTSTR

O nome do arquivo. Se um caminho completo não for especificado, a função usará a sequência de pesquisa especificada pela função LoadLibrary.

dwHandle

Tipo: DWORD

Esse parâmetro é ignorado.

[in] dwLen

Tipo: DWORD

O tamanho, em bytes, do buffer apontado pelo parâmetro lpData.

Chame a função GetFileVersionInfoSize primeiro para determinar o tamanho, em bytes, das informações de versão de um arquivo. O membro dwLen deve ser igual ou maior que esse valor.

Se o buffer apontado por lpData não for grande o suficiente, a função truncará as informações de versão do arquivo para o tamanho do buffer.

[out] lpData

Tipo: LPVOID

Ponteiro para um buffer que recebe as informações de versão do arquivo.

Você pode usar esse valor em uma chamada subsequente para a função VerQueryValue para recuperar dados do buffer.

Valor de retorno

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

As informações de versão do arquivo foram corrigidas e não foram corrigidas. A parte fixa contém informações como o número da versão. A parte não fixa contém itens como cadeias de caracteres. No anterior, GetFileVersionInfo estava tirando informações de versão do binário (exe/dll). Atualmente, ele está consultando a versão fixa do arquivo neutro de linguagem (exe/dll) e a parte não fixa do arquivo mui, mescla-as e retorna ao usuário. Se o binário especificado não tiver um arquivo mui, o comportamento será como na versão anterior.

Chame a função GetFileVersionInfoSize antes de chamar a função GetFileVersionInfo. Para recuperar informações do buffer de informações da versão do arquivo, use a função VerQueryValue.

Nota

O cabeçalho winver.h define GetFileVersionInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winver.h (inclua Windows.h)
biblioteca	Version.lib
de DLL	Api-ms-win-core-version-l1-1-0.dll