Partilhar via

Função GetFileVersionInfoExW (winver.h)

  • Artigo

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

Sintaxe

BOOL GetFileVersionInfoExW(
  [in]  DWORD   dwFlags,
  [in]  LPCWSTR 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 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 é ignorado.

[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 é retornada, 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.

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

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.

Nota

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 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 Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [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

Consulte também

Conceitual

GetFileVersionInfo

GetFileVersionInfoSizeEx

de referência de

VS_VERSIONINFO

VerQueryValue

informações de versão