다음을 통해 공유

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
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부터 사용 가능