Connection Manager Priority Constants
These constants define the priority of the connections that are defined in the dwPriority member of the CONNMGR_CONNECTIONINFO structure and requested by the application. Connection Manager arbitrates among multiple connection requests, trying to satisfy as many as possible at a time but giving preference to higher priorities.
The following table shows the Connection Manager priority constants.
| Value | Description |
|---|---|
| CONNMGR_PRIORITY_VOICE | Highest priority. A voice connection. |
| CONNMGR_PRIORITY_USERINTERACTIVE | A user-initiated action caused this request and the Connection Manager user interface (UI) is currently pending on the creation of this connection. This is appropriate for an interactive browsing session, or if the user selects "MORE" at the bottom of a truncated mail message. |
| CONNMGR_PRIORITY_USERBACKGROUND | A user-initiated connection that has recently become idle. |
| CONNMGR_PRIORITY_USERIDLE | Interactive user task that has been idle for an application-specified time. The application should toggle the state between this constant and CONNMGR_PRIORITY_USERINTERACTIVE as the user uses the application. This helps Connection Manager optimize responsiveness to the interactive application, while sharing the connection with background applications. |
| CONNMGR_PRIORITY_HIPRIBKGND | High-priority background connection. |
| CONNMGR_PRIORITY_IDLEBKGND | Idle-priority background connection. |
| CONNMGR_PRIORITY_EXTERNALINTERACTIVE | Connection is requested on behalf of an entity that is external to Connection Manager, but the current session is an interactive task that has been initiated by the user.. For example, the AT Command Interpreter does not directly go through Connection Manager, but Connection Manager can detect and, if necessary, disconnect any connections established for this application.
Note Connection Manager currently cannot disconnect external calls. |
| CONNMGR_PRIORITY_LOWBKGND | Lowest priority. Only connects if another higher-priority client is already using the same path. This option is ideal for an application that wants to exchange information packets if a connection is already active but would not initiate the establishment of a connection for this purpose. An example for such a scenario is an Instant Messenger application that wants to send and receive messages only when a connection is already active. |
See Also
CONNMGR_CONNECTIONINFO | Connection Manager API Constants
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.