Função GetFileVersionInfoExA (winver.h)

Artigo
06/01/2023

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

Sintaxe

BOOL GetFileVersionInfoExA(
  [in]  DWORD  dwFlags,
  [in]  LPCSTR lpwstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Parâmetros

[in] dwFlags

Tipo: DWORD

Controla as DLLs mui (se houver) das quais o recurso de versão é extraído. O valor desse sinalizador deve corresponder aos sinalizadores passados para a chamada GetFileVersionInfoSizeEx correspondente, que foi usada para determinar o tamanho do buffer passado no parâmetro dwLen . Zero ou mais dos sinalizadores a seguir.

Valor	Significado
FILE_VER_GET_LOCALISED 0x01	Carrega todo o recurso de versão (cadeias de caracteres e informações de versão binária) do arquivo MUI correspondente, se disponível.
FILE_VER_GET_NEUTRAL 0x02	Carrega as cadeias de caracteres de recurso de versão do arquivo MUI correspondente, se disponível, e carrega as informações de versão binária (VS_FIXEDFILEINFO) do arquivo neutro de idioma correspondente, se disponível.
FILE_VER_GET_PREFETCHED 0x04	Indica uma preferência para version.dll tentar pré-carregar a imagem fora do bloqueio do carregador para evitar a contenção. Esse sinalizador não altera o comportamento ou a semântica da função.

[in] lpwstrFilename

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 é reservado e espera-se que seja zero (0).

[in] dwLen

Tipo: DWORD

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

Chame a função GetFileVersionInfoSizeEx primeiro para determinar o tamanho, em bytes, das informações de versão de um arquivo. O parâmetro 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

Quando essa função retorna, contém um ponteiro para um buffer que contém 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

Chame a função GetFileVersionInfoSizeEx antes de chamar a função GetFileVersionInfoEx . 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 GetFileVersionInfoEx 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 Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [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