Função GetFileVersionInfoW (winver.h)

Artigo
08/28/2023

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

Sintaxe

BOOL GetFileVersionInfoW(
  [in]  LPCWSTR 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

Este 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.

Retornar valor

Tipo: BOOL

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

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

Comentários

As informações de versão do arquivo corrigiram e não foram corrigidas. A parte fixa contém informações como número de versão. A parte não fixa contém itens como cadeias de caracteres. No passado , GetFileVersionInfo estava obtendo 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 .

Observação

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 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

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	winver.h (inclua Windows.h)
Biblioteca	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll