LINEOPERATOR
A version of this page is also available for
4/8/2010
The LINEOPERATOR structure shows all the ways an operator can identify itself and is used in the LINEOPERATORSTATUS structure and with lineGetOperatorStatus and lineSetPreferredOperator calls.
Syntax
typedef struct lineoperator_tag {
DWORD dwIndex;
DWORD dwValidFields;
DWORD dwStatus;
TCHAR lpszLongName[MAX_LENGTH_OPERATOR_LONG];
TCHAR lpszShortName[MAX_LENGTH_OPERATOR_SHORT];
TCHAR lpszNumName[MAX_LENGTH_OPERATOR_NUMERIC];
} LINEOPERATOR, * LPLINEOPERATOR;
Members
dwIndex
Indicates the preferred operator index, presumably the same as its priority.Note
This field should be set to LINEOPERATOR_USEFIRSTAVAILABLEINDEX when referencing a current or available operator.
dwValidFields
Indicates which fields are valid. Possible values are listed in the following table.Value Description LINEOPFORMAT_ALPHASHORT
Short text description.
LINEOPFORMAT_ALPHALONG
Long text description.
LINEOPFORMAT_NUMERIC
Numeric description.
LINEOPFORMAT_NONE
No fields are valid.
dwStatus
Indicates status of the given operator. Possible values are listed in the following table.Value Description LINEOPSTATUS_UNKNOWN
Operator status is unknown.
LINEOPSTATUS_AVAILABLE
Operator is available.
LINEOPSTATUS_CURRENT
Current operator being used.
LINEOPSTATUS_FORBIDDEN
Operator is forbidden.
- lpszLongName
Extended representation of the operator name, maximum 32 bytes.
- lpszShortName
Abbreviated representation of the operator name, maximum 16 bytes.
- lpszNumName
Numerical representation of the operator name, maximum 16 bytes.
Requirements
| Header | extapi.h |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |