Método IDebugControl3::AddExtension (dbgeng.h)

Artículo
02/23/2024

El método AddExtension carga una biblioteca de extensiones en el motor del depurador.

Sintaxis

HRESULT AddExtension(
  [in]  PCSTR    Path,
  [in]  ULONG    Flags,
  [out] PULONG64 Handle
);

Parámetros

[in] Path

Especifica la ruta de acceso completa y el nombre de archivo de la biblioteca de extensiones que se va a cargar.

[in] Flags

Establecer en cero.

[out] Handle

Recibe el identificador de la biblioteca de extensiones cargada.

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 la biblioteca de extensiones ya se ha cargado, se devuelve el identificador de la biblioteca ya cargada. La biblioteca de extensiones no se vuelve a cargar.

La biblioteca de extensiones se carga en el motor de host y Path contiene una ruta de acceso y un nombre de archivo para esta instancia del motor del depurador.

AddExtension no completa el proceso de carga e inicialización del archivo DLL de extensión. Para que la extensión esté disponible para su uso, realice una llamada posterior a GetExtensionFunction.

Para obtener más información sobre el uso de bibliotecas de extensiones, consulte Llamadas a extensiones y funciones de extensión.