IDebugControl::CallExtension-Methode (dbgeng.h)

Artikel
02/06/2025

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 aufrufende Erweiterung enthält. Wenn Handle null ist, führt das Modul die Erweiterungsbibliothekskette durch, die nach der Erweiterung sucht.

[in] Function

Gibt den Namen der zu aufrufenden 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.

Bemerkungen

Wenn Handle null ist, durchsucht das Modul jede Erweiterungsbibliothek, bis eine gefunden wird, 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.