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

Artículo
02/27/2024

El método CallExtension llama a una extensión del depurador.

Sintaxis

HRESULT CallExtension(
  [in]           ULONG64 Handle,
  [in]           PCSTR   Function,
  [in, optional] PCSTR   Arguments
);

Parámetros

[in] Handle

Especifica el identificador de la biblioteca de extensiones que contiene la extensión a la que se va a llamar. Si Handle es cero, el motor recorrerá la cadena de la biblioteca de extensiones en busca de la extensión.

[in] Function

Especifica el nombre de la extensión a la que se va a llamar.

[in, optional] Arguments

Especifica los argumentos que se van a pasar a la extensión. Los argumentos son una cadena que la extensión analizará, al igual que la extensión analizará los argumentos pasados cuando se le llame como un comando de extensión.

Valor devuelto

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

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

Comentarios

Si Handle es cero, el motor busca en cada biblioteca de extensiones hasta que encuentre uno que contenga la extensión; Se llamará a la extensión. Si la extensión devuelve DEBUG_EXTENSION_CONTINUE_SEARCH, la búsqueda continuará.

Para obtener más información sobre el uso de bibliotecas de extensiones, vea Calling Extensions and Extension Functions.