IHostTask::SetPriority 메서드

아티클
08/09/2011

현재 IHostTask 인스턴스가 나타내는 작업의 스레드 우선 순위 수준을 호스트에서 조정하도록 요청합니다.

HRESULT SetPriority (
    [in] int newPriority
);

매개 변수

newPriority
[in] 현재 IHostTask 인스턴스가 나타내는 작업의 요청된 스레드 우선 순위 값을 나타내는 정수입니다.

반환 값

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

설명

스레드의 우선 순위 수준을 부분적으로 따르는 라운드 로빈 시스템을 사용하여 스레드에 처리 시간이 부여됩니다. SetPriority를 사용하면 CLR에서 현재 작업의 스레드 우선 순위 수준을 설정할 수 있습니다. 다음 newPriority 값을 사용할 수 있습니다.

THREAD_PRIORITY_ABOVE_NORMAL
THREAD_PRIORITY_BELOW_NORMAL
THREAD_PRIORITY_HIGHEST
THREAD_PRIORITY_IDLE
THREAD_PRIORITY_LOWEST
THREAD_PRIORITY_NORMAL
THREAD_PRIORITY_TIME_CRITICAL

CLR은 Thread.Priority의 값이 사용자 코드에 의해 수정될 때 SetPriority를 호출합니다. 호스트는 스레드 우선 순위 할당에 대한 자체 알고리즘을 정의할 수 있으며 이 요청을 무시할 수도 있습니다.

참고
SetPriority는 스레드 우선 순위 수준의 변경 여부를 보고하지 않습니다.작업의 스레드 우선 순위 수준 값을 확인하려면 IHostTask::GetPriority를 호출합니다.