Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The LINEOPERATORstructure shows all the ways an operator can identify itself and is used in the LINEOPERATORSTATUSstructure and with lineGetOperatorStatusand lineSetPreferredOperatorcalls.

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

See Also