ImagehlpApiVersionEx

[Now Supported on Windows NT]

The ImagehlpApiVersionEx function modifies the version information maintained by IMAGEHLP.

LPAPI_VERSION ImagehlpApiVersionEx(

IN OUT LPAPI_VERSION AppVersion  
);  

Parameters

AppVersion

A pointer to an API_VERSION structure. This structure should contain valid version information.

Return Values

The ImagehlpApiVersionEx function returns a pointer to an API_VERSION structure.

Remarks

Use the ImagehlpApiVersionEx function to indicate to IMAGEHLP which version of IMAGEHLP the application was built with. IMAGEHLP uses this information to ensure compatibility if a function changes in the future. For example, consider stack walking through kernel-mode callback frames (which exist in Windows NT 4.0, where User and GDI exist in kernel mode). If you call ImagehlpApiVersionEx to set API_VERSION.Revision to at least 4, StackWalk will continue through a callback stackframe; if API_VERSION.Revision is less than 4, StackWalk will stop at the kernel transition.

Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.