2.2.3.1.34 LINEDEVSTATUSFLAGS_Constants

The LINEDEVSTATUSFLAGS_Constants are bit-flag constants that describe a collection of Boolean line device status items.

Constant/value

Description

LINEDEVSTATUSFLAGS_CONNECTED

0x00000001

Specifies whether the line must be connected to TAPI. If TRUE, the line must be connected and TAPI must be able to operate on the line device. If FALSE, the line must be disconnected and the application must be unable to control the line device through TAPI.

LINEDEVSTATUSFLAGS_MSGWAIT

0x00000002

Indicates whether the line must have a packet waiting. If TRUE, a packet must be waiting; if FALSE, no packet must be waiting.

LINEDEVSTATUSFLAGS_INSERVICE

0x00000004

Indicates whether the line must be in service. If TRUE, the line must be in service; if FALSE, the line must be out of service.

LINEDEVSTATUSFLAGS_LOCKED

0x00000008

Indicates whether the line is locked or unlocked. This bit is most often used with line devices that are associated with cellular phones. Many cellular phones have a security mechanism that requires the entry of a password to enable the phone to place calls. This bit can be used to indicate to applications that the phone must be locked and cannot be used to place calls until the password is entered on the user interface of the phone so that the application can present an appropriate alert to the user.

LINEDEVSTATUSFLAGS_Constants are used within the dwDevStatusFlags member of the LINEDEVSTATUS packet.