ICLRTaskManager::CreateTask 메서드
CLR(공용 언어 런타임)에서 새 작업을 만들도록 명시적으로 요청합니다.
HRESULT CreateTask (
[out] ICLRTask **pTask
);
매개 변수
- pTask
[out] 새로 만든 ICLRTask의 주소에 대한 포인터이거나, 작업을 만들지 못한 경우 null입니다.
반환 값
HRESULT |
설명 |
---|---|
S_OK |
메서드가 성공적으로 반환했습니다. |
HOST_E_CLRNOTAVAILABLE |
CLR이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다. |
HOST_E_TIMEOUT |
호출 시간이 초과되었습니다. |
HOST_E_NOT_OWNER |
호출자가 잠금을 소유하고 있지 않습니다. |
HOST_E_ABANDONED |
차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다. |
E_FAIL |
알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다. |
E_OUTOFMEMORY |
메모리가 부족하여 요청된 리소스를 할당할 수 없습니다. |
설명
사용자 코드에서 System.Threading 네임스페이스의 형식을 사용하여 스레드를 만들거나 스레드 풀 크기가 증가하는 경우에는 CLR이 초기화될 때 새 작업이 자동으로 만들어집니다. 비관리 코드에서 관리되는 함수를 호출할 때도 새 작업이 만들어집니다.
CreateTask를 사용하면 호스트에서 CLR에 새 작업을 만들도록 명시적으로 요청할 수 있습니다. 예를 들어 호스트에서 이 메서드를 호출하여 데이터 구조를 미리 초기화할 수 있습니다.
중요 |
---|
새 작업은 일시 중단 상태로 반환되며 호스트가 IHostTask::Start를 명시적으로 호출할 때까지 이 상태로 유지됩니다. |
요구 사항
플랫폼: .NET Framework 시스템 요구 사항 참조
헤더: MSCorEE.h
라이브러리: MSCorEE.dll에 리소스로 포함됨
.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0