다음을 통해 공유

IHostTask::SetPriority 메서드

  • 아티클

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

구문

HRESULT SetPriority (  
    [in] int newPriority  
);

매개 변수

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

Return Value

HRESULT 설명
S_OK SetPriority가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 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를 호출하여 작업의 스레드 우선 순위 수준 값을 확인합니다.

스레드 우선 순위 수준 값은 Win32 SetThreadPriority 함수에 의해 정의됩니다. 스레드 우선 순위에 대한 자세한 내용은 Windows 플랫폼 설명서를 참조하세요.

요구 사항

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

헤더: MSCorEE.h

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

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

참고 항목