IDebugControl::GetExtensionFunction-Methode (dbgeng.h)

Artikel
02/23/2024

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

[in] FuncName

Gibt den Namen der zurückzugebenden Erweiterungsfunktion an. Beim Durchsuchen der Erweiterungsbibliotheken nach der Funktion stellt die Debugger-Engine dem Namen "EFN" voran. Wenn FuncName beispielsweise "SampleFunction" ist, 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.

Hinweise

Erweiterungsbibliotheken werden in die Host-Engine geladen, und Erweiterungsfunktionen können nicht remote aufgerufen werden. Der aktuelle Client darf kein Debugclient sein, er muss zur Host-Engine gehören.

Die Erweiterungsfunktion kann über einen beliebigen Funktionsprototyp verfügen. 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.