IDebugControl3::GetExtensionFunction-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetExtensionFunction--Methode gibt einen Zeiger auf eine Erweiterungsfunktion aus einer Erweiterungsbibliothek zurück.

Syntax

HRESULT GetExtensionFunction(
  [in]  ULONG64 Handle,
  [in]  PCSTR   FuncName,
  [out] FARPROC *Function
);

Parameter

[in] Handle

Gibt das Handle der Erweiterungsbibliothek an, die die Erweiterungsfunktion enthält. Wenn Handle null ist, führt das Modul die Erweiterungsbibliothekskette durch, die nach der Erweiterungsfunktion sucht.

[in] FuncName

Gibt den Namen der zurückzugebenden Erweiterungsfunktion an. Beim Durchsuchen der Erweiterungsbibliotheken für die Funktion wird das Debuggermodul dem Namen "EFN" vorangestellt. Wenn FuncName- beispielsweise "SampleFunction" lautet, durchsucht das Modul die Erweiterungsbibliotheken nach "_EFN_SampleFunction".

[out] Function

Empfängt die Erweiterungsfunktion.

Rückgabewert

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

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Erweiterungsbibliotheken werden in das Hostmodul geladen, und Erweiterungsfunktionen können nicht remote aufgerufen werden. Der aktuelle Client darf kein Debugclient sein, er muss zum Hostmodul gehören.

Die Erweiterungsfunktion kann einen beliebigen Funktionsprototyp aufweisen. Damit jedes Programm diese Erweiterungsfunktion aufrufen kann, sollte die Erweiterungsfunktion in den richtigen Prototyp umgewandelt werden.

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