IDebugControl3::GetWindbgExtensionApis32-Methode (dbgeng.h)

Artikel
02/26/2024

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 von der WdbgExts-API verwendeten Funktionen. Das nSize-Element dieser Struktur muss auf die Größe der Struktur festgelegt werden, bevor es 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.

Hinweise

Wenn Sie Wdbgexts.h in Ihren 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 namens ExtensionApis gespeichert werden.

Eine Liste der von der WdbgExts-API bereitgestellten Funktionen finden Sie unter WdbgExts Functions.