IHostThreadPoolManager::QueueUserWorkItem 메서드

아티클
08/09/2011

실행할 함수를 큐에 대기시키고 이 함수에 사용되는 데이터가 포함된 개체를 지정합니다. 스레드를 사용할 수 있게 되면 함수가 실행됩니다.

HRESULT QueueUserWorkItem (
    [in] LPTHREAD_START_ROUTINE Function,
    [in] PVOID Context,
    [in] ULONG Flags
);

매개 변수

Function
[in] 실행할 함수를 나타내는 함수 포인터입니다.
Context
[in] Function에 사용될 데이터가 포함된 개체입니다.
Flags
[in] Win32 QueueUserWorkItem 메서드에 정의되어 실행을 제어하는 플래그 값 중 하나입니다.

반환 값

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

설명

QueueUserWorkItem은 스레드 풀에 있는 작업자 스레드의 큐에 작업 항목을 대기시킵니다. 시그니처 및 매개 변수 형식은 이름이 같은 해당 Win32 함수의 시그니처 및 매개 변수 형식과 같습니다. 자세한 내용은 Windows 플랫폼 설명서를 참조하십시오.