CreateDebuggingInterfaceFromVersion3 함수

CreateVersionStringFromModule 함수에서 반환되는 CLR(공용 언어 런타임) 버전 문자열을 수락하고 해당 디버거 인터페이스(일반적으로 ICorDebug)를 반환합니다.

문법

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

매개 변수

iDebuggerVersion
[in] 디버거가 예상하는 인터페이스의 버전입니다.

szDebuggeeVersion
[in] CreateVersionStringFromModule 함수에 의해 반환되는 대상 디버그기의 CLR 버전 문자열입니다.

szApplicationGroupId
[in] macOS에서 실행되는 샌드박스 프로세스의 애플리케이션 그룹 ID를 나타내는 문자열입니다. 프로세스가 macOS 또는 다른 플랫폼의 샌드박스에서 실행되고 있지 않은 경우 NULL을 전달합니다.

pLibraryProvider
[in] DBI 및 DAC를 찾기 위한 콜백 인터페이스 인스턴스입니다. ICLRDebuggingLibraryProvider3 인터페이스를 참조하세요.

ppCordb
[out] COM 개체(IUnknown)에 대한 포인터에 대한 포인터입니다. 이 개체는 반환되기 전에 ICorDebug 개체로 캐스팅됩니다.

반환 값

S_OK
ppCordb 는 ICorDebug 인터페이스 인터페이스를 구현하는 유효한 개체를 참조합니다.

E_INVALIDARG
null szDebuggeeVersion 이거나 ppCordb null입니다.

CORDBG_E_DEBUG_COMPONENT_MISSING
CLR 디버깅에 필요한 구성 요소를 배치할 수 없습니다. 대상 CoreCLR.dll 동일한 디렉터리에서 mscordbi.dll 또는mscordaccore.dll찾을 수 없습니다.

CORDBG_E_INCOMPATIBLE_PROTOCOL
mscordbi.dll 또는 mscordaccore.dll 대상 CoreCLR.dll동일한 버전이 아닙니다.

E_FAIL (또는 기타 E_ 반환 코드)
ICorDebug 인터페이스를 반환할 수 없습니다.

비고

반환되는 인터페이스는 대상 프로세스에서 CLR에 연결하고 CLR이 실행 중인 관리 코드를 디버깅하는 기능을 제공합니다.

요구 사항

플랫폼:.NET 지원 운영 체제를 참조하세요.

헤더: dbgshim.h

라이브러리: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET 버전: .NET 6.0 이후 사용 가능