ICLRTaskManager::CreateTask 메서드

CLR(공용 언어 런타임)에서 새 작업을 만들도록 명시적으로 요청합니다.

구문

HRESULT CreateTask (  
    [out] ICLRTask **pTask  
);

pTask
[out] 새로 만든 ICLRTask의 주소에 대한 포인터이거나, 작업을 만들 수 없는 경우 null입니다.

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

CLR은 초기화 시, 사용자 코드가 System.Threading 네임스페이스의 형식을 사용하여 스레드를 만들 때 또는 스레드 풀의 크기가 증가할 때 자동으로 새 작업을 만듭니다. 비관리 코드가 관리형 함수를 호출할 때도 작업을 만듭니다.

CreateTask를 사용하면 호스트가 CLR에서 새 작업을 만들도록 명시적으로 요청할 수 있습니다. 예를 들어 호스트는 이 메서드를 호출하여 데이터 구조를 미리 초기화할 수 있습니다.

중요

새 작업은 일시 중단된 상태로 반환되며 호스트가 IHostTask::Start를 명시적으로 호출할 때까지 일시 중단된 상태로 유지됩니다.

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

헤더: MSCorEE.h

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

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