6.76 LceUsePriority
Instructs the session to use the specified job priority. This functions sets the execution priority of the session and any jobs related to the session on the host system.
|
BOOL |
LceUsePriority |
(int |
iSession, |
|
|
|
int |
iValue ) |
Parameters
|
iSession |
The session identifier as returned by LceGetSessionId. |
|
iValue |
The priority number. The default value is 20. |
Return Values
TRUE is returned if the session can accept the value.
FALSE is returned if an error occurs.
Notes
|
Portability Considerations |
You should be aware of the implications of using this option. If you specify an unreasonable priority, you may severely impact the host system by monopolizing all of the system resources. On the host, you should never use a priority less than 10. |
- This function should be executed after the LceGetSessionId and must be specified before the LceOpenSession is executed. The priority cannot be changed once the session is open.
- This function performs no communications to the host.
- This function is ignored on Linux hosts.
Related Functions