CreateDebuggingInterfaceFromVersion2 işlevi

CreateVersionStringFromModule işlevinden döndürülen ortak dil çalışma zamanı (CLR) sürüm dizesini kabul eder ve ilgili hata ayıklayıcı arabirimini (genellikle ICorDebug) döndürür.

Sözdizimi

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

Parametreler

iDebuggerVersion
[in] Hata ayıklayıcının beklediği arabirim sürümü.

szDebuggeeVersion
[in] Hedef debuggee içindeki CLR'nin CreateVersionStringFromModule işlevi tarafından döndürülen sürüm dizesi.

szApplicationGroupId
[in] macOS'ta çalışan korumalı bir işlemin uygulama grubu kimliğini temsil eden dize. İşlem macOS veya diğer platformlardaki bir korumalı alanda çalışmıyorsa NULL değerini geçirin.

ppCordb
[out] COM nesnesine (IUnknown işaretçisi) işaret eden bir işaretçi. Bu nesne döndürülmeden önce bir ICorDebug nesnesine döndürülür.

Dönüş değeri

S_OK
ppCordb ICorDebug arabirim arabirimini uygulayan geçerli bir nesneye başvurur.

E_INVALIDARG
veya szDebuggeeVersionppCordb null.

CORDBG_E_DEBUG_COMPONENT_MISSING
CLR hata ayıklaması için gereken bir bileşen bulunamıyor. hedef CoreCLR.dll ile aynı dizinde mscordbi.dll veyamscordaccore.dllbulunamadı.

CORDBG_E_INCOMPATIBLE_PROTOCOL
mscordbi.dll veya mscordaccore.dll hedef CoreCLR.dllile aynı sürüm değildir.

E_FAIL (veya diğer E_ iade kodları)
ICorDebug arabirimi döndürülemiyor.

Açıklamalar

Döndürülen arabirim, hedef işlemde CLR'ye ekleme ve CLR'nin çalıştığı yönetilen kodun hatalarını ayıklama olanağı sağlar.

Gereksinimler

Platform: Bkz. .NET tarafından desteklenen işletim sistemleri.

Üst bilgi: dbgshim.h

Kitaplık: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET Sürümleri: .NET Core 3.1'den itibaren kullanılabilir