IDebugControl2::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, sucht die Engine in der Erweiterungsbibliothekskette nach der Erweiterungsfunktion.

[in] FuncName

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