Função GetFileVersionInfoSizeExA (winver.h)

Artigo
11/20/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 que é definida como zero porque essa função a define como zero. Esse parâmetro existe por motivos históricos.

Valor de retorno

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.

Observações

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.

Nota

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

GetFileVersionInfoEx

GetFileVersionInfoSize

de referência de

VS_VERSIONINFO

VerQueryValue

informações de versão

Compartilhar via