Connection Manager Priority Constants
A version of this page is also available for
4/8/2010
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_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. Using this priority setting will suppress error messages when the connection cannot be established. Use Connection Manager Control Flag Constants to suppress error messages. |
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. |
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. Also connects if a cached connection to the same network exists and each connection along the connection path is automatically connected. DTPT, Wi-Fi, wired Ethernet, GPRS and 1xRTT connections are considered automatically connected. CSD connections are not considered automatically connected. |
Requirements
| Header | connmgr.h |
| Windows Embedded CE | Windows CE .NET 4.2 and later, Windows Embedded NavReady 2009 |