Função CreateDebuggingInterfaceFromVersion

Aceita uma cadeia de caracteres de versão CLR (Common Language Runtime) 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.

Valor de retorno

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

E_INVALIDARG
szDebuggeeVersion Ou ppCordb é nulo.

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

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

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

Observações

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: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: dbgshim.h

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

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