IHostTaskManager::CreateTask 메서드

아티클
08/09/2011

호스트에서 새 작업을 만들도록 요청합니다.

HRESULT CreateTask (
    [in]  DWORD stacksize, 
    [in]  LPTHREAD_START_ROUTINE pStartAddress,
    [in]  PVOID pParameter,
    [out] IHostTask **ppTask
);

매개 변수

stacksize
[in] 요청된 스택의 요청된 크기(바이트)입니다. 크기의 기본값은 0입니다.
pStartAddress
[in] 작업에서 실행할 함수에 대한 포인터입니다.
pParameter
[in] 함수에 전달할 사용자 데이터에 대한 포인터이며 함수에서 매개 변수를 사용하지 않으면 null입니다.
ppTask
[out] 호스트에서 만든 IHostTask 인스턴스의 주소에 대한 포인터이며 작업을 만들 수 없는 경우에는 null입니다. 작업은 IHostTask::Start 호출을 통해 명시적으로 시작될 때까지 중지된 상태를 유지합니다.

반환 값

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

설명

CLR에서는 CreateTask를 호출하여 새로운 작업을 만들도록 호스트에 요청합니다. 호스트는 IHostTask 인스턴스에 대한 인터페이스 포인터를 반환합니다. 반환된 작업은 IHostTask::Start 호출을 통해 명시적으로 시작될 때까지는 중지된 상태를 유지합니다.