Método IDebugControl4::GetExtensionFunctionWide (dbgeng.h)

Artículo
08/07/2023

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

Sintaxis

HRESULT GetExtensionFunctionWide(
  [in]  ULONG64 Handle,
  [in]  PCWSTR  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.