LINEOPERATOR

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

Extended TAPI Structures