Función ImagehlpApiVersionEx (dbghelp.h)

Artículo
08/23/2023

Modifica la información de versión de la biblioteca usada por la aplicación.

Sintaxis

LPAPI_VERSION IMAGEAPI ImagehlpApiVersionEx(
  [in] LPAPI_VERSION AppVersion
);

Parámetros

[in] AppVersion

Puntero a una estructura de API_VERSION que contiene información de versión válida para la aplicación.

Valor devuelto

El valor devuelto es un puntero a una estructura API_VERSION .

Comentarios

Use la función ImagehlpApiVersionEx para indicar la versión de la biblioteca con la que se creó la aplicación. La biblioteca usa esta información para garantizar la compatibilidad. Por ejemplo, considere la posibilidad de recorrer marcos de pila de devolución de llamada en modo kernel (el usuario y GDI existen en modo kernel). Si llama a ImagehlpApiVersionEx para establecer el miembro Revision en la versión 4 o posterior, la función StackWalk64 continuará a través de un marco de pila de devolución de llamada. De lo contrario, si establece Revisión en una versión anterior a 4, StackWalk64 se detendrá en la transición del kernel.

Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.