Método IDebugControl3::GetWindbgExtensionApis32 (dbgeng.h)

Artículo
08/07/2023

El método GetWindbgExtensionApis32 devuelve una estructura que facilita el uso de la API WdbgExts.

Sintaxis

HRESULT GetWindbgExtensionApis32(
  [in, out] PWINDBG_EXTENSION_APIS32 Api
);

Parámetros

[in, out] Api

Recibe una estructura WINDBG_EXTENSION_APIS32. Esta estructura contiene las funciones usadas por la API WdbgExts. El miembro nSize de esta estructura debe establecerse en el tamaño de la estructura antes de pasarlo a este método.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	El valor de Api->nSize no es igual al tamaño de la estructura WINDBG_EXTENSION_APIS32.

Comentarios

Si está incluyendo Wdbgexts.h en el código de extensión, debe llamar a este método durante la inicialización del archivo DLL de extensión (consulte DepurarExtensionInitialize).

Muchas funciones WdbgExts son realmente macros. Para asegurarse de que estas macros funcionan correctamente, la estructura recibida por el parámetro api debe almacenarse en una variable global denominada ExtensionApis.

Para obtener una lista de las funciones proporcionadas por la API de WdbgExts, consulte Funciones WdbgExts.