| INT SetPriority( |
| |
INT nPriority |
|
| ); |
Set the priority assigned to the specified server.
Parameters
- nPriority
- An integer that specifies the server priority. It may be one of
the following values:
| Value |
Description |
| INET_PRIORITY_BACKGROUND |
This priority significantly reduces the memory, processor and
network resource utilization for the server. It is typically used
with lightweight services running in the background that are
designed for few client connections. The server thread will be
assigned a lower scheduling priority and will be frequently
forced to yield execution to other threads. |
| INET_PRIORITY_LOW |
This priority lowers the overall resource utilization for the
server and meters the processor utilization for the server
thread. The server thread will be assigned a lower scheduling
priority and will occasionally be forced to yield execution to
other threads. |
| INET_PRIORITY_NORMAL |
The default priority which balances resource and processor
utilization. This is the priority that is initially assigned to
the server when it is started, and it is recommended that most
applications use this priority. |
| INET_PRIORITY_HIGH |
This priority increases the overall resource utilization for
the server and the thread will be given higher scheduling
priority. It is not recommended that this priority be used on a
system with a single processor. |
| INET_PRIORITY_CRITICAL |
This priority can significantly increase processor, memory
and network utilization. The server thread will be given higher
scheduling priority and will be more responsive to client
connection requests. It is not recommended that this priority be
used on a system with a single processor. |
Return Value
If the method succeeds, the return value is the previous priority
assigned to the server. If the method
fails, the return value is INET_ERROR.
Remarks
The SetPriority method changes
the current priority assigned to the specified server. Client
connections that are accepted after this method is called will inherit
the new priority as their default priority. Previously existing client
connections will not be affected by this function.
Higher priority values increase the thread priority and processor
utilization for each client session. You should only change the server
priority if you understand the impact it will have on the system and
have thoroughly tested your application. Configuring the server to run
with a higher priority can have a negative effect on the performance
of other programs running on the system.
Requirements
Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cswsock11.h
Import Library: cswskv11.lib
See Also
GetPriority
|