IDebugControl3::GetWindbgExtensionApis32-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetWindbgExtensionApis32--Methode gibt eine Struktur zurück, die die Verwendung der WdbgExts-API erleichtert.

Syntax

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

Parameter

[in, out] Api

Empfängt eine WINDBG_EXTENSION_APIS32 Struktur. Diese Struktur enthält die Funktionen, die von der WdbgExts-API verwendet werden. Das nSize Member dieser Struktur muss auf die Größe der Struktur festgelegt werden, bevor sie an diese Methode übergeben wird.

Rückgabewert

Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Der Wert von Api->nSize entspricht nicht der Größe der Struktur WINDBG_EXTENSION_APIS32.

Bemerkungen

Wenn Sie Wdbgexts.h in Den Erweiterungscode einschließen, sollten Sie diese Methode während der Initialisierung der Erweiterungs-DLL aufrufen (siehe DebugExtensionInitialize).

Viele WdbgExts-Funktionen sind wirklich Makros. Um sicherzustellen, dass diese Makros ordnungsgemäß funktionieren, sollte die vom Api Parameter empfangene Struktur in einer globalen Variablen mit dem Namen ExtensionApisgespeichert werden.

Eine Liste der funktionen, die von der WdbgExts-API bereitgestellt werden, finden Sie unter WdbgExts Functions.