IHostTask::SetPriority 方法
请求宿主为当前的 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
当 Thread.Priority 的值被用户代码修改时,CLR 将调用 SetPriority。 宿主可以为线程定义自己的优先级分配算法,并且可以随时忽略此请求。
注意 |
---|
SetPriority 不报告该线程优先级别是否已更改。调用 IHostTask::GetPriority 以确定任务的线程优先级别的值。 |
线程优先级别值由 Win32 SetThreadPriority 函数定义。 有关线程优先级的更多信息,请参见 Windows 平台文档。
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**MSCorEE.h
**库:**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0