IDebugControl2::CallExtension-Methode (dbgeng.h)

Artikel
02/23/2024

Die CallExtension-Methode ruft eine Debuggererweiterung auf.

Syntax

HRESULT CallExtension(
  [in]           ULONG64 Handle,
  [in]           PCSTR   Function,
  [in, optional] PCSTR   Arguments
);

Parameter

[in] Handle

Gibt das Handle der Erweiterungsbibliothek an, die die aufzurufende Erweiterung enthält. Wenn Handle null ist, sucht die Engine in der Erweiterungsbibliothekskette nach der Erweiterung.

[in] Function

Gibt den Namen der aufzurufenden Erweiterung an.

[in, optional] Arguments

Gibt die Argumente an, die an die Erweiterung übergeben werden sollen. Argumente ist eine Zeichenfolge, die von der Erweiterung analysiert wird, genau wie die Erweiterung Argumente analysiert, die an sie übergeben werden, wenn sie als Erweiterungsbefehl aufgerufen wird.

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 Handle null ist, durchsucht die Engine jede Erweiterungsbibliothek, bis sie eine findet, die die Erweiterung enthält. Die Erweiterung wird dann aufgerufen. Wenn die Erweiterung DEBUG_EXTENSION_CONTINUE_SEARCH zurückgibt, wird die Suche fortgesetzt.

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