根據指定的版本資訊建立 ICorDebug 物件。
此函式在 .NET Framework 4 中已過時。 相反地,若要取得共用語言執行階段 (CLR) 2.0 的介面,請使用 ICLRRuntimeInfo::GetInterface 方法,並指定類別識別碼CLSID_CLRDebuggingLegacy和介面識別碼IID_ICorDebug。 若要取得 CLR 4 或更新版本的介面,請呼叫 CLRCreateInstance 函式,並指定類別識別碼CLSID_CLRDebugging和介面識別碼IID_ICLRDebugging。
語法
HRESULT CreateDebuggingInterfaceFromVersion (
[in] int iDebuggerVersion,
[in] LPCWSTR szDebuggeeVersion,
[out] IUnknown **ppCordb
);
參數
iDebuggerVersion
[在]偵錯工具所期望的版本 ICorDebug 。 如需有效值,請參閱 CorDebugInterfaceVersion 列舉。
szDebuggeeVersion
[在]與要偵錯之應用程式或程式相關聯的 Common Language 執行階段版本。 如需擷取此值的相關資訊,請參閱 GetVersionFromProcess 或 GetRequestedRuntimeVersion 方法。
ppCordb
[出]接收物件指標 ICorDebug 的位置。
傳回值
除了下列值之外,這個方法還會傳回 WinError.h 檔案中定義的標準 COM 錯誤碼。
| 回傳碼 | Description |
|---|---|
| S_OK | 方法已順利完成。 |
| E_INVALIDARG |
szDebuggeeVersion 或 ppCordb 為空值,或版本字串不正確。 |
備註
參數對 szDebuggeeVersion 應至對應的 MSCorDbi.dll版本。
需求
平台: 請參閱 系統需求。
標題: MSCorEE.h
圖書館: MSCorEE.dll
.NET Framework 版本: 自 2.0 起可用