ICLRDebugManager::BeginConnection 메서드

아티클
08/09/2011

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

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

매개 변수

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

반환 값

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

설명

ICLRDebugManager는 작업 목록을 식별자 및 이름과 연결할 수 있는 BeginConnection, SetConnectionTasks 및 EndConnection 메서드를 제공합니다.

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

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