Función CreateDebuggingInterfaceFromVersion2

Artículo
09/22/2023

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

Sintaxis

HRESULT CreateDebuggingInterfaceFromVersion2 (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [in] LPCWSTR szApplicationGroupId,
    [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.

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: disponible a partir de .NET Core 3.1

Compartir vía