ImagehlpApiVersionEx

The ImagehlpApiVersionEx function modifies the information about the version of the library used by the application.

LPAPI_VERSION ImagehlpApiVersionEx(
  LPAPI_VERSION AppVersion  
);

Parameters

AppVersion

[in] Pointer to an API_VERSION structure that contains valid version information for your application.

Return Values

The return value is a pointer to an API_VERSION structure.

Remarks

Use the ImagehlpApiVersionEx function to indicate the version of the library with which the application was built. The library uses this information to ensure compatibility. For example, consider walking through kernel-mode callback stack frames (which exist in Windows NT 4.0, where User and GDI exist in kernel mode). If you call ImagehlpApiVersionEx to set the Revision member to version 4 or later, the StackWalk function will continue through a callback stack frame. Otherwise, if you set Revision to a version earlier than 4, StackWalk will stop at the kernel transition.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Dbghelp.h.
  Library: Use Dbghelp.lib.

See Also

Debug Help Library Overview, DbgHelp Functions, API_VERSION, ImagehlpApiVersion