Top Description Fields Methods
com.sun.jna.platform.win32

public Interface Version

extends StdCallLibrary
Imports
com.sun.jna.Native, .Pointer, com.sun.jna.ptr.IntByReference, .PointerByReference, com.sun.jna.win32.StdCallLibrary, .W32APIOptions

Provides access to the w32 version library.

Field Summary

Modifier and TypeField and Description
public static final Version
Inherited from com.sun.jna.win32.StdCallLibrary:
FUNCTION_MAPPERSTDCALL_CONVENTION

Method Summary

Modifier and TypeMethod and Description
public boolean

Returns:

If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError.
GetFileVersionInfo
(String
The name of the file. If a full path is not specified, the function uses the search sequence specified by the LoadLibrary function.
lptstrFilename
,
int
This parameter is ignored.
dwHandle
,
int
The size, in bytes, of the buffer pointed to by the lpData parameter. Call the GetFileVersionInfoSize function first to determine the size, in bytes, of a file's version information. The dwLen member should be equal to or greater than that value. If the buffer pointed to by lpData is not large enough, the function truncates the file's version information to the size of the buffer.
dwLen
,
Pointer
Pointer to a buffer that receives the file-version information. You can use this value in a subsequent call to the VerQueryValue function to retrieve data from the buffer.
lpData
)

Retrieves version information for the specified file.

public int

Returns:

If the function succeeds, the return value is the size, in bytes, of the file's version information. If the function fails, the return value is zero. To get extended error information, call GetLastError.
GetFileVersionInfoSize
(String
The name of the file of interest. The function uses the search sequence specified by the LoadLibrary function.
lptstrFilename
,
IntByReference
A pointer to a variable that the function sets to zero.
lpdwHandle
)

Determines whether the operating system can retrieve version information for a specified file.

public boolean

Returns:

If the specified version-information structure exists, and version information is available, the return value is nonzero. If the address of the length buffer is zero, no value is available for the specified version-information name. If the specified name does not exist or the specified resource is not valid, the return value is zero.
VerQueryValue
(Pointer
The version-information resource returned by the GetFileVersionInfo function.
pBlock
,
String
The version-information value to be retrieved.
lpSubBlock
,
PointerByReference
When this method returns, contains the address of a pointer to the requested version information in the buffer pointed to by pBlock. The memory pointed to by lplpBuffer is freed when the associated pBlock memory is freed.
lplpBuffer
,
IntByReference
When this method returns, contains a pointer to the size of the requested data pointed to by lplpBuffer: for version information values, the length in characters of the string stored at lplpBuffer; for translation array values, the size in bytes of the array stored at lplpBuffer; and for root block, the size in bytes of the structure.
puLen
)

Retrieves specified version information from the specified version-information resource.

Field Detail

INSTANCEback to summary
public static final Version INSTANCE

Method Detail

GetFileVersionInfoback to summary
public boolean GetFileVersionInfo(String lptstrFilename, int dwHandle, int dwLen, Pointer lpData)

Retrieves version information for the specified file.

Parameters
lptstrFilename:String

The name of the file. If a full path is not specified, the function uses the search sequence specified by the LoadLibrary function.

dwHandle:int

This parameter is ignored.

dwLen:int

The size, in bytes, of the buffer pointed to by the lpData parameter. Call the GetFileVersionInfoSize function first to determine the size, in bytes, of a file's version information. The dwLen member should be equal to or greater than that value. If the buffer pointed to by lpData is not large enough, the function truncates the file's version information to the size of the buffer.

lpData:Pointer

Pointer to a buffer that receives the file-version information. You can use this value in a subsequent call to the VerQueryValue function to retrieve data from the buffer.

Returns:boolean

If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError.

GetFileVersionInfoSizeback to summary
public int GetFileVersionInfoSize(String lptstrFilename, IntByReference lpdwHandle)

Determines whether the operating system can retrieve version information for a specified file. If version information is available, GetFileVersionInfoSize returns the size, in bytes, of that information.

Parameters
lptstrFilename:String

The name of the file of interest. The function uses the search sequence specified by the LoadLibrary function.

lpdwHandle:IntByReference

A pointer to a variable that the function sets to zero.

Returns:int

If the function succeeds, the return value is the size, in bytes, of the file's version information. If the function fails, the return value is zero. To get extended error information, call GetLastError.

VerQueryValueback to summary
public boolean VerQueryValue(Pointer pBlock, String lpSubBlock, PointerByReference lplpBuffer, IntByReference puLen)

Retrieves specified version information from the specified version-information resource. To retrieve the appropriate resource, before you call VerQueryValue, you must first call the GetFileVersionInfoSize function, and then the GetFileVersionInfo function.

Parameters
pBlock:Pointer

The version-information resource returned by the GetFileVersionInfo function.

lpSubBlock:String

The version-information value to be retrieved.

lplpBuffer:PointerByReference

When this method returns, contains the address of a pointer to the requested version information in the buffer pointed to by pBlock. The memory pointed to by lplpBuffer is freed when the associated pBlock memory is freed.

puLen:IntByReference

When this method returns, contains a pointer to the size of the requested data pointed to by lplpBuffer: for version information values, the length in characters of the string stored at lplpBuffer; for translation array values, the size in bytes of the array stored at lplpBuffer; and for root block, the size in bytes of the structure.

Returns:boolean

If the specified version-information structure exists, and version information is available, the return value is nonzero. If the address of the length buffer is zero, no value is available for the specified version-information name. If the specified name does not exist or the specified resource is not valid, the return value is zero.