다음을 통해 공유

ICLRDebugManager::BeginConnection 메서드

  • 아티클

호스트와 디버거 간에 새 연결을 설정하여 작업 목록을 식별자 및 식별 이름과 연결합니다.

구문

HRESULT BeginConnection (  
    [in] CONNID dwConnectionId,  
    [in, string] wchar_t* szConnectionName  
);

매개 변수

dwConnectionId
[in] 공용 언어 런타임(CLR) 작업 목록과 연결할 식별자입니다.

szConnectionName
[in] CLR 작업 목록과 연결할 식별 이름입니다.

Return Value

HRESULT 설명
S_OK BeginConnection가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE CLR이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT 호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER 호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED 차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL 알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환한 후 CLR은 프로세스 내에서 더 이상 사용할 수 없습니다. 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.
E_INVALIDARG dwConnectionId이 0이었거나 BeginConnection이 이미 이 dwConnectionId 값을 사용하여 호출되었거나 szConnectionName이 null이었습니다.
E_OUTOFMEMORY 이 연결과 연관된 작업 목록을 저장하기에 충분한 메모리를 할당할 수 없었습니다.

설명

ICLRDebugManager는 작업 목록을 식별자 및 식별 이름과 연결하기 위해 BeginConnection, SetConnectionTasks 및 EndConnection의 세 가지 메서드를 제공합니다.

중요

이 세 가지 메서드는 각 작업 집합에 대해 특정 순서로 호출되어야 합니다. BeginConnection은 새 연결을 설정하기 위해 먼저 호출됩니다. 다음으로 SetConnectionTasks가 호출되어 해당 연결과 연결할 작업 집합을 제공합니다. EndConnection은 작업 목록과 식별자 및 친숙한 식별 이름 간의 연결을 제거하기 위해 마지막으로 호출됩니다. 그러나 다른 연결에 대한 호출은 중첩될 수 있습니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능

참고 항목