Função CreateDebuggingInterfaceFromVersion

Artigo
10/04/2023

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

Sintaxe

HRESULT CreateDebuggingInterfaceFromVersion (
    [in]  LPCWSTR      szDebuggeeVersion,
    [out] IUnknown**   ppCordb,
);

Parâmetros

szDebuggeeVersion
[in] Cadeia de caracteres de versão do CLR no depurador de destino, que é retornado pela função CreateVersionStringFromModule.

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

Retornar valor

S_OK
ppCordb referencia um objeto válido que implementa a interface ICorDebug.

E_INVALIDARG
Se szDebuggeeVersion ou ppCordb é nulo.

CORDBG_E_DEBUG_COMPONENT_MISSING
Não é possível localizar um componente necessário para a depuração de CLR. O mscordbi.dll ou o mscordaccore.dll não foi encontrado no mesmo diretório que o CoreCLR.dll de destino.

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

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

Comentários

A interface retornada fornece as instalações para anexar a um CLR em um processo de destino e depurar o código gerenciado que o CLR está executando.

Requisitos

Plataformas: confira Sistemas operacionais com suporte no .NET.

Cabeçalho: dbgshim.h

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

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

Compartilhar via