Função CreateDebuggingInterfaceFromVersion (.NET Framework)

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

Essa função está obsoleta no .NET Framework 4. Em vez disso, para obter uma interface para o CLR (Common Language Runtime) 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
[in] A versão do ICorDebug que é esperado pelo depurador. Consulte a enumeração CorDebugInterfaceVersion para obter valores válidos.

szDebuggeeVersion
[in] A versão de 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
[out] O local que recebe um ponteiro para o ICorDebug objeto.

Valor de retorno

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

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

Observações

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

Requirements

Plataformas: Consulte os Requisitos do Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

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

Consulte também

• Funções de hospedagem CLR preteridas