IDebugControl2::GetWindbgExtensionApis32-Methode (dbgeng.h)

Artikel
02/23/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 Funktionen, die von der WdbgExts-API verwendet werden. Der nSize-Member dieser Struktur muss auf die Größe der Struktur festgelegt werden, bevor er an diese Methode übergeben wird.

Rückgabewert

Diese Methode gibt möglicherweise auch andere Fehlerwerte zurück. 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 funktionen, die von der WdbgExts-API bereitgestellt werden, finden Sie unter WdbgExts Functions.