ICLRTask::SetTaskIdentifier 메서드

아티클
08/09/2011

지정한 식별자 값을 현재 ICLRTask 인스턴스가 나타내는 작업에 연결하도록 CLR(공용 언어 런타임)에 지시합니다.

HRESULT SetTaskIdentifier (
    [in] DWORD Asked
);

매개 변수

Asked
[in] 현재 ICLRTask 인스턴스가 나타내는 작업에 연결할 공용 언어 런타임의 고유 식별자입니다.

반환 값

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

설명

호스트는 식별자를 작업에 연결하여 CLR(공용 언어 런타임)과 호스트를 디버깅 환경에 통합할 수 있도록 합니다. CLR(공용 언어 런타임)에는 이 식별자가 아무런 의미가 없습니다. CLR(공용 언어 런타임)은 식별자를 디버거 응용 프로그램에 전달합니다. 디버거는 이 식별자를 사용하여 CLR(공용 언어 런타임) 호출 스택을 호스트 호출 스택에 연결할 수 있으므로 디버거의 사용자 인터페이스에 해당 추적 정보를 통합하여 표시할 수 있습니다.