CM_PRIORITY (Compact 2013)

3/26/2014

This data type represents the priority of obtaining a suitable connection for an application, when an application requests multiple connections, and a new connection request is made before one of the prior connection requests completes.

Syntax

typedef int CM_PRIORITY;

CM_CONST( CM_PRIORITY_USER_INTERACTIVE_LOWEST, 0 );
CM_CONST( CM_PRIORITY_USER_INTERACTIVE_HIGHEST, 0x7FFFFFFF );

CM_CONST( CM_PRIORITY_BACKGROUND_LOWEST , 0x80000000 );
CM_CONST( CM_PRIORITY_BACKGROUND_HIGHEST, -1 );
DECLARE_HANDLE(CM_CONNECTION_HANDLE);
CM_CONST(CM_HOST_NAME_LENGTH, DNS_MAX_NAME_BUFFER_LENGTH);

Remarks

The default priority for a connection is 0.

Priorities are divided into user interactive and background. The user interactive priority range is intended for connections resulting from explicit user requests. The background priority range is intended for connections acquired for background tasks.

The range of priority spans all integers from -2^31 to (+2^31)-1.

The User Interactive range is 0 (lowest) to (+2^31)-1 (highest).

The Background range is (-2^31) (lowest) to -1 (highest).

Note   These are not INT_MIN and INT_MAX, which may vary by platform.

CM_CONNECTION_HANDLE identifies an instance of a connection that can be used by an application. An application uses the connection handle to acquire connection for its use and other operations.

Requirements

Header

cmnet.h

Library

cmnet.lib

See Also

Reference

Connection Manager Connectivity Data Types
CmSetPriority