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
