winver.h

#include <winapifamily.h>

/*****************************************************************************\ * * * winver.h - Version management functions, types, and definitions * * * * Include file for VER.DLL. This library is * * designed to allow version stamping of Windows executable files* * and of special .VER files for DOS executable files. * * * * Copyright (c) Microsoft Corporation. All rights reserved. * * * \*****************************************************************************/

/**************************************************************************** ** * * winver.h - Version management functions, types, and definitions * * * * Include file for VER.DLL. This library is * * designed to allow version stamping of Windows executable files* * and of special .VER files for DOS executable files. * * * * Copyright (c) Microsoft Corporation. All rights reserved. * * * \*****************************************************************************/

#ifndef VER_H

#define VER_H

#include <SpecStrings.h> #include <verrsrc.h>

#ifdef __cplusplus

extern

"C"

{

#endif

#pragma region Desktop Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#ifndef RC_INVOKED /* RC doesn't need to see the rest of this */

/* ----- Function prototypes ----- */

DWORD

APIENTRY

__stdcall

VerFindFileA

(

_In_ DWORD uFlags,

DWORD

uFlags

_In_ LPCSTR szFileName,

LPCSTR

szFileName

_In_opt_ LPCSTR szWinDir,

LPCSTR

szWinDir

_In_ LPCSTR szAppDir,

LPCSTR

szAppDir

_Out_writes_(*puCurDirLen) LPSTR szCurDir,

LPSTR

szCurDir

_Inout_ PUINT puCurDirLen,

PUINT

puCurDirLen

_Out_writes_(*puDestDirLen) LPSTR szDestDir,

LPSTR

szDestDir

_Inout_ PUINT puDestDirLen

PUINT

puDestDirLen

);

DWORD

APIENTRY

__stdcall

VerFindFileW

(

_In_ DWORD uFlags,

DWORD

uFlags

_In_ LPCWSTR szFileName,

LPCWSTR

szFileName

_In_opt_ LPCWSTR szWinDir,

LPCWSTR

szWinDir

_In_ LPCWSTR szAppDir,

LPCWSTR

szAppDir

_Out_writes_(*puCurDirLen) LPWSTR szCurDir,

LPWSTR

szCurDir

_Inout_ PUINT puCurDirLen,

PUINT

puCurDirLen

_Out_writes_(*puDestDirLen) LPWSTR szDestDir,

LPWSTR

szDestDir

_Inout_ PUINT puDestDirLen

PUINT

puDestDirLen

);

#ifdef UNICODE

#define VerFindFile VerFindFileW

#else

#define VerFindFile VerFindFileA #endif // !UNICODE

#endif // RC_INVOKED

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Desktop Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)

#ifndef RC_INVOKED

DWORD

APIENTRY

__stdcall

VerInstallFileA

(

_In_ DWORD uFlags,

DWORD

uFlags

_In_ LPCSTR szSrcFileName,

LPCSTR

szSrcFileName

_In_ LPCSTR szDestFileName,

LPCSTR

szDestFileName

_In_ LPCSTR szSrcDir,

LPCSTR

szSrcDir

_In_ LPCSTR szDestDir,

LPCSTR

szDestDir

_In_ LPCSTR szCurDir,

LPCSTR

szCurDir

_Out_writes_(*puTmpFileLen) LPSTR szTmpFile,

LPSTR

szTmpFile

_Inout_ PUINT puTmpFileLen

PUINT

puTmpFileLen

);

DWORD

APIENTRY

__stdcall

VerInstallFileW

(

_In_ DWORD uFlags,

DWORD

uFlags

_In_ LPCWSTR szSrcFileName,

LPCWSTR

szSrcFileName

_In_ LPCWSTR szDestFileName,

LPCWSTR

szDestFileName

_In_ LPCWSTR szSrcDir,

LPCWSTR

szSrcDir

_In_ LPCWSTR szDestDir,

LPCWSTR

szDestDir

_In_ LPCWSTR szCurDir,

LPCWSTR

szCurDir

_Out_writes_(*puTmpFileLen) LPWSTR szTmpFile,

LPWSTR

szTmpFile

_Inout_ PUINT puTmpFileLen

PUINT

puTmpFileLen

);

#ifdef UNICODE

#define VerInstallFile VerInstallFileW

#else

#define VerInstallFile VerInstallFileA #endif // !UNICODE

#endif // RC_INVOKED

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP) */

#pragma endregion #pragma region Desktop Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#ifndef RC_INVOKED

/* Returns size of version info in bytes */

DWORD

APIENTRY

__stdcall

GetFileVersionInfoSizeA

(

_In_ LPCSTR lptstrFilename, /* Filename of version stamped file */

LPCSTR

lptstrFilename

/* Filename of version stamped file */

_Out_opt_ LPDWORD lpdwHandle /* Information for use by GetFileVersionInfo */

LPDWORD

lpdwHandle

/* Information for use by GetFileVersionInfo */

);

/* Returns size of version info in bytes */

DWORD

APIENTRY

__stdcall

GetFileVersionInfoSizeW

(

_In_ LPCWSTR lptstrFilename, /* Filename of version stamped file */

LPCWSTR

lptstrFilename

/* Filename of version stamped file */

_Out_opt_ LPDWORD lpdwHandle /* Information for use by GetFileVersionInfo */

LPDWORD

lpdwHandle

/* Information for use by GetFileVersionInfo */

);

#ifdef UNICODE

#define GetFileVersionInfoSize GetFileVersionInfoSizeW

#else

#define GetFileVersionInfoSize GetFileVersionInfoSizeA #endif // !UNICODE

/* Read version info into buffer */

BOOL

APIENTRY

__stdcall

GetFileVersionInfoA

(

_In_ LPCSTR lptstrFilename, /* Filename of version stamped file */

LPCSTR

lptstrFilename

/* Filename of version stamped file */

_Reserved_ DWORD dwHandle, /* Information from GetFileVersionSize */

DWORD

dwHandle

/* Information from GetFileVersionSize */

_In_ DWORD dwLen, /* Length of buffer for info */

DWORD

dwLen

/* Length of buffer for info */

_Out_writes_bytes_(dwLen) LPVOID lpData /* Buffer to place the data structure */

LPVOID

lpData

/* Buffer to place the data structure */

);

/* Read version info into buffer */

BOOL

APIENTRY

__stdcall

GetFileVersionInfoW

(

_In_ LPCWSTR lptstrFilename, /* Filename of version stamped file */

LPCWSTR

lptstrFilename

/* Filename of version stamped file */

_Reserved_ DWORD dwHandle, /* Information from GetFileVersionSize */

DWORD

dwHandle

/* Information from GetFileVersionSize */

_In_ DWORD dwLen, /* Length of buffer for info */

DWORD

dwLen

/* Length of buffer for info */

_Out_writes_bytes_(dwLen) LPVOID lpData /* Buffer to place the data structure */

LPVOID

lpData

/* Buffer to place the data structure */

);

#ifdef UNICODE

#define GetFileVersionInfo GetFileVersionInfoW

#else

#define GetFileVersionInfo GetFileVersionInfoA #endif // !UNICODE

#endif // RC_INVOKED

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Application or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#ifndef RC_INVOKED

DWORD APIENTRY GetFileVersionInfoSizeExA(_In_ DWORD dwFlags, _In_ LPCSTR lpwstrFilename, _Out_ LPDWORD lpdwHandle);

DWORD

__stdcall

GetFileVersionInfoSizeExA

(

DWORD

dwFlags

LPCSTR

lpwstrFilename

LPDWORD

lpdwHandle

);

DWORD APIENTRY GetFileVersionInfoSizeExW(_In_ DWORD dwFlags, _In_ LPCWSTR lpwstrFilename, _Out_ LPDWORD lpdwHandle);

DWORD

__stdcall

GetFileVersionInfoSizeExW

(

DWORD

dwFlags

LPCWSTR

lpwstrFilename

LPDWORD

lpdwHandle

);

#ifdef UNICODE

#define GetFileVersionInfoSizeEx GetFileVersionInfoSizeExW

#else

#define GetFileVersionInfoSizeEx GetFileVersionInfoSizeExA #endif // !UNICODE

BOOL APIENTRY GetFileVersionInfoExA(_In_ DWORD dwFlags,

BOOL

__stdcall

GetFileVersionInfoExA

(

DWORD

dwFlags

_In_ LPCSTR lpwstrFilename,

LPCSTR

lpwstrFilename

_Reserved_ DWORD dwHandle,

DWORD

dwHandle

_In_ DWORD dwLen,

DWORD

dwLen

_Out_writes_bytes_(dwLen) LPVOID lpData);

LPVOID

lpData

);

BOOL APIENTRY GetFileVersionInfoExW(_In_ DWORD dwFlags,

BOOL

__stdcall

GetFileVersionInfoExW

(

DWORD

dwFlags

_In_ LPCWSTR lpwstrFilename,

LPCWSTR

lpwstrFilename

_Reserved_ DWORD dwHandle,

DWORD

dwHandle

_In_ DWORD dwLen,

DWORD

dwLen

_Out_writes_bytes_(dwLen) LPVOID lpData);

LPVOID

lpData

);

#ifdef UNICODE

#define GetFileVersionInfoEx GetFileVersionInfoExW

#else

#define GetFileVersionInfoEx GetFileVersionInfoExA #endif // !UNICODE

#endif // RC_INVOKED

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Desktop Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)

#ifndef RC_INVOKED

#endif /* !RC_INVOKED */

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP) */

#pragma endregion #pragma region Application Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#ifndef RC_INVOKED

DWORD

APIENTRY

__stdcall

VerLanguageNameA

(

_In_ DWORD wLang,

DWORD

wLang

_Out_writes_(cchLang) LPSTR szLang,

LPSTR

szLang

_In_ DWORD cchLang

DWORD

cchLang

);

DWORD

APIENTRY

__stdcall

VerLanguageNameW

(

_In_ DWORD wLang,

DWORD

wLang

_Out_writes_(cchLang) LPWSTR szLang,

LPWSTR

szLang

_In_ DWORD cchLang

DWORD

cchLang

);

#ifdef UNICODE

#define VerLanguageName VerLanguageNameW

#else

#define VerLanguageName VerLanguageNameA #endif // !UNICODE

BOOL

APIENTRY

__stdcall

VerQueryValueA

(

_In_ LPCVOID pBlock,

LPCVOID

pBlock

_In_ LPCSTR lpSubBlock,

LPCSTR

lpSubBlock

_Outptr_result_buffer_(_Inexpressible_("buffer can be PWSTR or DWORD*")) LPVOID * lplpBuffer,

LPVOID

lplpBuffer

_Out_ PUINT puLen

PUINT

puLen

);

BOOL

APIENTRY

__stdcall

VerQueryValueW

(

_In_ LPCVOID pBlock,

LPCVOID

pBlock

_In_ LPCWSTR lpSubBlock,

LPCWSTR

lpSubBlock

_Outptr_result_buffer_(_Inexpressible_("buffer can be PWSTR or DWORD*")) LPVOID * lplpBuffer,

LPVOID

lplpBuffer

_Out_ PUINT puLen

PUINT

puLen

);

#ifdef UNICODE

#define VerQueryValue VerQueryValueW

#else

#define VerQueryValue VerQueryValueA #endif // !UNICODE

#endif /* !RC_INVOKED */

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion

#ifdef __cplusplus

}

#endif

#endif /* !VER_H */