Compartir a través de

Función CreateDebuggingInterfaceFromVersion3

  • Artículo

Acepta una cadena de versión de Common Language Runtime (CLR) que se devuelve desde la función CreateVersionStringFromModule y devuelve una interfaz de depurador correspondiente (por lo general, ICorDebug).

Sintaxis

HRESULT CreateDebuggingInterfaceFromVersion3 (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [in] LPCWSTR szApplicationGroupId,
    [in] ICLRDebuggingLibraryProvider3* pLibraryProvider,
    [out] IUnknown** ppCordb,
);

Parámetros

iDebuggerVersion
[in] Versión de la interfaz que espera el depurador.

szDebuggeeVersion
[in] Cadena de versión de CLR en el código de destino que está siendo depurado, que es devuelto por la función CreateVersionStringFromModule.

szApplicationGroupId
[in] Cadena que representa el identificador de grupo de aplicaciones de un proceso de espacio aislado que se ejecuta en macOS. Pase NULL si el proceso no se ejecuta en un espacio aislado en macOS o en otras plataformas.

pLibraryProvider
[in] Instancia de interfaz de devolución de llamada para buscar DBI y DAC. Consulte la interfaz ICLRDebuggingLibraryProvider3.

ppCordb
[out] Puntero a un puntero a un objeto COM (IUnknown). Este objeto se convertirá en un objeto ICorDebug antes de que se devuelva.

Valor devuelto

S_OK
ppCordb hace referencia a un objeto válido que implementa la interfaz ICorDebug.

E_INVALIDARG
szDebuggeeVersion o ppCordb es nulo.

CORDBG_E_DEBUG_COMPONENT_MISSING
Componente que es necesario para que no se pueda encontrar la depuración de CLR. No se encontraron los archivos mscordbi.dll o mscordaccore.dll en el mismo directorio que CoreCLR.dll de destino.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Ni mscordbi.dll, ni mscordaccore.dll son la misma versión que CoreCLR.dll de destino.

E_FAIL (u otros códigos de retorno E_)
No se puede devolver una interfaz ICorDebug.

Comentarios

La interfaz que se devuelve proporciona las funciones para adjuntar a CLR en un proceso de destino y depurar el código administrado que ejecuta CLR.

Requisitos

Plataformas: consulte Sistemas operativos compatibles con .NET.

Encabezado: dbgshim.h

Biblioteca: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versiones de .NET: está disponible desde la versión 6.0 de .NET