Função CreateDebuggingInterfaceFromVersion3

Artigo
10/04/2023

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

Sintaxe

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

Parâmetros

iDebuggerVersion
[in] A versão da interface esperada pelo depurador.

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

szApplicationGroupId
[in] Uma cadeia de caracteres que representa a ID do grupo de aplicativos de um processo em área restrita em execução no macOS. Passe NULL se o processo não estiver em execução em uma área restrita no macOS ou em outras plataformas.

pLibraryProvider
[in] Uma instância de interface de retorno de chamada para localizar DBI e DAC. Consulte a interface ICLRDebuggingLibraryProvider3.

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 6.0

Compartilhar via