IDebugControl3::GetWindbgExtensionApis64-Methode (dbgeng.h)

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

Syntax

HRESULT GetWindbgExtensionApis64(
  [in, out] PWINDBG_EXTENSION_APIS64 Api
);

Parameter

[in, out] Api

Empfängt eine WINDBG_EXTENSION_APIS64 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_APIS64.

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.

Die von dieser Methode zurückgegebene WINDBG_EXTENSION_APIS64 Struktur dient demselben Zweck wie die der Rückruffunktion bereitgestellte WinDbgExtensionDllInit (verwendet von WdbgExts-Erweiterungen).

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

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Wdbgexts.h, Dbgeng.h, Wdbgexts.h)