IDebugControl3::AddExtension-Methode (dbgeng.h)

Artikel
02/23/2024

Die AddExtension-Methode lädt eine Erweiterungsbibliothek in das Debuggermodul.

Syntax

HRESULT AddExtension(
  [in]  PCSTR    Path,
  [in]  ULONG    Flags,
  [out] PULONG64 Handle
);

Parameter

[in] Path

Gibt den vollqualifizierten Pfad und Dateinamen der zu ladenden Erweiterungsbibliothek an.

[in] Flags

Auf NULL festlegen.

[out] Handle

Empfängt das Handle der geladenen Erweiterungsbibliothek.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

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

Hinweise

Wenn die Erweiterungsbibliothek bereits geladen wurde, wird das Handle für die bereits geladene Bibliothek zurückgegeben. Die Erweiterungsbibliothek wird nicht erneut geladen.

Die Erweiterungsbibliothek wird in die Host-Engine geladen, und Path enthält einen Pfad und Dateinamen für diese instance der Debugger-Engine.

AddExtension schließt den Prozess des Ladens und Initialisierens der Erweiterungs-DLL nicht ab. Um die Erweiterung zur Verwendung zur Verfügung zu stellen, rufen Sie getExtensionFunction anschließend auf.

Weitere Informationen zur Verwendung von Erweiterungsbibliotheken finden Sie unter Aufrufen von Erweiterungen und Erweiterungsfunktionen.