IDebugControl::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, wird die Erweiterungsbibliothekskette von der Engine nach der Erweiterung gesucht.

[in] Function

Gibt den Namen der aufzurufenden Erweiterung an.

[in, optional] Arguments

Gibt die Argumente an, die an die Erweiterung übergeben werden sollen. Argumente sind 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 0 ist, durchsucht das Modul jede Erweiterungsbibliothek, bis eine Erweiterung 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.