imagehlpApiVersionEx 函数 (dbghelp.h)

项目
08/23/2023

修改应用程序使用的库的版本信息。

语法

LPAPI_VERSION IMAGEAPI ImagehlpApiVersionEx(
  [in] LPAPI_VERSION AppVersion
);

参数

[in] AppVersion

指向包含应用程序的有效版本信息的 API_VERSION 结构的指针。

返回值

返回值是指向 API_VERSION 结构的指针。

备注

使用 ImagehlpApiVersionEx 函数指示生成应用程序的库的版本。库使用此信息来确保兼容性。例如，请考虑遍历内核模式回调堆栈帧， (用户和 GDI 存在于内核模式) 。如果调用 ImagehlpApiVersionEx 将 Revision 成员设置为版本 4 或更高版本，则 StackWalk64 函数将继续执行回调堆栈帧。否则，如果将 Revision 设置为低于 4 的版本， 则 StackWalk64 将在内核转换时停止。

所有 DbgHelp 函数（例如此函数）都是单线程的。因此，从多个线程调用此函数可能会导致意外行为或内存损坏。若要避免这种情况，必须将多个线程中的所有并发调用同步到此函数。