Partilhar via


Função CreateDebuggingInterfaceFromVersion (.NET Framework)

Cria um objeto ICorDebug com base nas informações de versão especificadas.

Esta função está obsoleta no .NET Framework 4. Em vez disso, para obter uma interface para o Common Language Runtime (CLR) 2.0, use o método ICLRRuntimeInfo::GetInterface e especifique o identificador de classe CLSID_CLRDebuggingLegacy e o identificador de interface IID_ICorDebug. Para obter uma interface para CLR 4 ou posterior, chame a função CLRCreateInstance e especifique o identificador de classe CLSID_CLRDebugging e o identificador de interface IID_ICLRDebugging.

Sintaxe

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

Parâmetros

iDebuggerVersion
[em] A versão ICorDebug disso é esperada pelo depurador. Consulte a enumeração CorDebugInterfaceVersion para valores válidos.

szDebuggeeVersion
[em] A versão do Common Language Runtime associada ao aplicativo ou processo a ser depurado. Consulte o método GetVersionFromProcess ou GetRequestedRuntimeVersion para obter informações sobre como recuperar esse valor.

ppCordb
[saídas] O local que recebe um ponteiro para o ICorDebug objeto.

Valor Devolvido

Esse método retorna códigos de erro COM padrão conforme definido no arquivo WinError.h, além dos seguintes valores.

Código de retorno Descrição
S_OK O método foi concluído com êxito.
E_INVALIDARG szDebuggeeVersion ou é null, ou ppCordb a cadeia de caracteres de versão está incorreta.

Observações

O szDebuggeeVersion parâmetro mapeia para a versão correspondente do MSCorDbi.dll.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

Versões do .NET Framework: Disponível desde 2.0

Consulte também