Função CreateDebuggingInterfaceFromVersionEx

Artigo
03/05/2024

Aceita uma cadeia de caracteres de versão CLR (Common Language Runtime) que é retornada da função CreateVersionStringFromModule e retorna uma interface de depurador correspondente (normalmente, ICorDebug).

Sintaxe

HRESULT CreateDebuggingInterfaceFromVersionEx (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [out] IUnknown** ppCordb,
);

Parâmetros

iDebuggerVersion
[em] A versão da interface que o depurador espera.

szDebuggeeVersion
[em] Cadeia de caracteres de versão do CLR no debuggee de destino, que é retornada pela função CreateVersionStringFromModule .

ppCordb
[saídas] Ponteiro para um ponteiro para um objeto COM (IUnknown). Esse objeto será convertido em um objeto ICorDebug antes de ser retornado.

Valor devolvido

S_OK
ppCordb faz referência a um objeto válido que implementa a interface de interface ICorDebug.

E_INVALIDARG
Ou szDebuggeeVersionppCordb é nulo.

CORDBG_E_DEBUG_COMPONENT_MISSING
Um componente necessário para depuração CLR não pode ser localizado. O mscordbi.dll ou mscordaccore.dll não foi encontrado no mesmo diretório que o CoreCLR.dll de destino.

CORDBG_E_INCOMPATIBLE_PROTOCOL
Ou mscordbi.dll ou mscordaccore.dll não é a mesma versão que o CoreCLR.dll de destino.

E_FAIL (ou outros E_ códigos de retorno)
Não é possível retornar uma interface ICorDebug.

Observações

A interface retornada fornece os recursos para anexar a um CLR em um processo de destino e depurar o código gerenciado que o CLR está executando.

Requisitos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: dbgshim.h

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

Versões do .NET: Disponível desde o .NET Core 2.1

Partilhar via