Método IDebugControl::GetExtensionFunction (dbgeng.h)

Artículo
02/23/2024

El método GetExtensionFunction devuelve un puntero a una función de extensión desde una biblioteca de extensiones.

Sintaxis

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

Parámetros

[in] Handle

Especifica el identificador de la biblioteca de extensiones que contiene la función de extensión. Si Handle es cero, el motor recorrerá la cadena de bibliotecas de extensiones que busca la función de extensión.

[in] FuncName

Especifica el nombre de la función de extensión que se va a devolver. Al buscar las bibliotecas de extensiones para la función, el motor del depurador anteponerá "EFN" al nombre. Por ejemplo, si FuncName es "SampleFunction", el motor buscará las bibliotecas de extensiones para "_EFN_SampleFunction".

[out] Function

Recibe la función de extensión.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Las bibliotecas de extensiones se cargan en el motor de host y las funciones de extensión no se pueden llamar de forma remota. El cliente actual no debe ser un cliente de depuración, debe pertenecer al motor de host.

La función de extensión puede tener cualquier prototipo de función. Para que cualquier programa llame a esta función de extensión, la función de extensión debe convertirse al prototipo correcto.

Para obtener más información sobre el uso de funciones de extensión, vea Llamar a extensiones y funciones de extensión.