Função GetFileVersionInfoSizeA (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, 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.

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

Nota

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

de referência de

VS_VERSIONINFO

VerQueryValue

informações de versão

Compartilhar via