Share via


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

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

Reference

Extended TAPI Structures