Função GetFileVersionInfoSizeExA (winver.h)

Artigo
03/04/2024

Determina se o sistema operacional pode recuperar informações de versão para um arquivo especificado. Se as informações de versão estiverem disponíveis, GetFileVersionInfoSizeEx retornará o tamanho, em bytes, dessas informações.

Sintaxe

DWORD GetFileVersionInfoSizeExA(
  [in]            DWORD   dwFlags,
  [in]            LPCSTR  lpwstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Parâmetros

[in] dwFlags

Tipo: DWORD

Controla quais DLLs MUI (se houver) das quais o recurso de versão é extraído. 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 0x002	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.

[in] lpwstrFilename

Tipo: LPCTSTR

O nome do arquivo de interesse. A função usa a sequência de pesquisa especificada pela função LoadLibrary .

[out, optional] lpdwHandle

Tipo: LPDWORD

Quando essa função retorna, contém um ponteiro para uma variável definida como zero porque essa função a define como zero. Esse parâmetro existe por motivos históricos.

Retornar valor

Tipo: DWORD

Se a função for bem-sucedida, o valor retornado será o tamanho, em bytes, das informações de versão do arquivo.

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 . O tamanho retornado por GetFileVersionInfoSizeEx indica o tamanho do buffer necessário para as informações de versão retornadas por GetFileVersionInfoEx.

Observação

O cabeçalho winver.h define GetFileVersionInfoSizeEx 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 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 (incluir Windows.h)
Biblioteca	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll