Поделиться через


Функция ImagehlpApiVersionEx (dbghelp.h)

Изменяет сведения о версии библиотеки, используемой приложением.

Синтаксис

LPAPI_VERSION IMAGEAPI ImagehlpApiVersionEx(
  [in] LPAPI_VERSION AppVersion
);

Параметры

[in] AppVersion

Указатель на структуру API_VERSION , содержащую допустимые сведения о версии приложения.

Возвращаемое значение

Возвращаемое значение является указателем на структуру API_VERSION .

Комментарии

Используйте функцию ImagehlpApiVersionEx , чтобы указать версию библиотеки, с помощью которой было создано приложение. Библиотека использует эти сведения для обеспечения совместимости. Например, рассмотрите возможность прохождения кадров стека обратного вызова в режиме ядра (пользователь и GDI существуют в режиме ядра). Если вызвать ImagehlpApiVersionEx , чтобы задать для члена Revision версию 4 или более позднюю, функция StackWalk64 продолжит работу через кадр стека обратного вызова. В противном случае, если для параметра Revision задана версия до 4, StackWalk64 остановится при переходе ядра.

Все функции DbgHelp, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования

   
Целевая платформа Windows
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 5.1 или более поздней версии

См. также раздел

API_VERSION

Функции DbgHelp

ImagehlpApiVersion