Connection Manager Priority Constants

Send Feedback

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. Starting with Windows Mobile 5.0, use CONNMGR_FLAG_NO_ERROR_MSGS 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.

See Also


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.