IDebugControl2::GetWindbgExtensionApis64-Methode (dbgeng.h)

  • Artikel

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 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_APIS64.

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.

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

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

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Wdbgexts.h, Dbgeng.h, Wdbgexts.h)