Connection preferences table

Support

Supported from 6.1

Description

The following macros define values for the Connected Preference table fields.

The description is followed by the field type, and whether the specified field may be left null or not.

CONNECT_PREF_RANKING

Description

Ranking of this connection preference.

This information is used to specify the order in which attempts at connection should be carried out. The highest ranking is 1 and is always attempted. If this fails, a preference with rank 2 is then attempted, and so on. Ranking of 0 indicates that a connection preference is only being stored and is not used for connections.

For incoming connections, CommDb limits the ranking to 0 or 1. For outgoing connection preferences, the maximum ranking is the value in CONNECTION_ATTEMPTS field in the Global table.

Multiple records with the same ranking (except for 0) and the same direction are not allowed.

Type: TUint32. Null: no

See also:

• CONNECTION_ATTEMPTS

CONNECTION_PREF_DIRECTION

Description

The direction of the connection.

The directions are defined by the enum TCommDbConnectionDirection.

Type: TUint32. Null: no

See also:

• TCommDbConnectionDirection

CONNECT_PREF_BEARER_SET

Description

The bearers that can be used for this connection.

The bearers are defined by the enum TCommDbBearer. Values can be ORed together to indicate that either of the bearers could be used.

Type: TUint32. Null: no

See also:

• TCommDbBearer

CONNECT_PREF_DIALOG_PREF

Description

Determines whether or not the user should be should be prompted or warned with a dialog that a connection is going to be made.

The options are defined by the enum TCommDbDialogPref.

Type: TUint32. Null: no

See also:

• TCommDbDialogPref

CONNECT_PREF_IAP

Description

Identifier of preferred IAP for this connection, if this is an IAP type database.

For ISP type databases, see the subsequent fields.

Type: TUint32. Null: yes