Função GetFileVersionInfoSizeA (winver.h)

Artigo
03/13/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, GetFileVersionInfoSize retornará o tamanho, em bytes, dessas informações.

Sintaxe

DWORD GetFileVersionInfoSizeA(
  [in]            LPCSTR  lptstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Parâmetros

[in] lptstrFilename

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

Um ponteiro para uma variável que a função define como zero.

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 GetFileVersionInfoSize antes de chamar a função GetFileVersionInfo . O tamanho retornado por GetFileVersionInfoSize indica o tamanho do buffer necessário para as informações de versão retornadas por GetFileVersionInfo.

Observação

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