Compartir a través de


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

El método getExtensionFunction de devuelve un puntero a una función de extensión de 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 guiará la cadena de bibliotecas de extensiones buscando 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 información.

Código devuelto Descripción
S_OK
El método se realizó correctamente.

Observaciones

Las bibliotecas de extensiones se cargan en el motor 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 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, consulte Funciones de llamada y extensiones.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

AddExtension

CallExtension

GetExtensionByPath

IDebugControl

IDebugControl2

IDebugControl3