ICLRDebugManager::SetConnectionTasks 메서드

아티클
08/09/2011

ICLRTask 인스턴스 목록에 식별자와 이름을 연결합니다.

HRESULT SetConnectionTasks (
    [in] CONNID id,
    [in] DWORD dwCount,
    [in, size_is(dwCount)] ICLRTask **ppCLRTask
);

매개 변수

id
[in] ppCLRTask 배열을 연결할 연결에 대한 호스트별 식별자입니다.
dwCount
[in] ppCLRTask의 멤버 수입니다. 이 수는 0보다 커야 합니다.
ppCLRTask
[in] id로 식별되는 연결에 연결할 ICLRTask 포인터 배열입니다. 이 배열에는 멤버가 하나 이상 있어야 합니다.

반환 값

HRESULT	설명
S_OK	SetConnectionTasks에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT	호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER	호출자가 잠금을 소유하고 있지 않습니다.
HOST_E_ABANDONED	차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다.
E_FAIL	알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환한 후에는 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다.
E_INVALIDARG	BeginConnection이 이 id 값을 사용하여 호출되지 않았거나, dwCount 또는 id가 0이거나, ppCLRTask의 요소 중 하나가 null입니다.

설명

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

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

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