IDebugSymbols3::GetModuleVersionInformation method (dbgeng.h)

The GetModuleVersionInformation method returns version information for the specified module.

Syntax

HRESULT GetModuleVersionInformation(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [in]            PCSTR   Item,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  VerInfoSize
);

Parameters

[in] Index

Specifies the index of the module. If it is set to DEBUG_ANY_ID, the Base parameter is used to specify the location of the module instead.

[in] Base

If Index is DEBUG_ANY_ID, specifies the location in the target's memory address space of the base of the module. Otherwise it is ignored.

[in] Item

Specifies the version information being requested. This string corresponds to the lpSubBlock parameter of the function VerQueryValue. For details on the VerQueryValue function, see the Platform SDK.

[out, optional] Buffer

Receives the requested version information. If Buffer is NULL, this information is not returned.

[in] BufferSize

Specifies the size in characters of the buffer Buffer. This size includes the space for the '\0' terminating character.

[out, optional] VerInfoSize

Receives the size in characters of the version information. This size includes the space for the '\0' terminating character. If VerInfoSize is NULL, this information is not returned.

Return value

This method may also return other error values. See Return Values for more details.

Return code Description
S_OK
The method was successful.
S_FALSE
The size of the buffer was smaller than the size of the version information. In this case the buffer is filled with the truncated version information.
E_NOINTERFACE
The specified module was not found.

Remarks

Module version information is available only for loaded modules and may not be available in all sessions.

For more information about modules, see Modules.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See also

GetModuleByIndex

GetModuleByOffset2

GetNumberModules

IDebugSymbols2

IDebugSymbols3