Função CreateDebuggingInterfaceFromVersion (.NET Framework)

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

Essa função é 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 os identificadores de classe CLSID_CLRDebuggingLegacy e 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 de ICorDebug, esperada pelo depurador. Consulte a Enumeração CorDebugInterfaceVersion para obter valores válidos.

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

Valor Retornado

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 Descrição
S_OK O método foi concluído com sucesso.
E_INVALIDARG szDebuggeeVersion ou ppCordb é nulo ou a cadeia de caracteres de versão está incorreta.

Comentários

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

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: MSCorEE.dll

Versões do .NET Framework: disponíveis desde 2.0

Confira também