LINEOPERATOR (Compact 2013)

  • Article

3/26/2014

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

See Also

Reference

Extended TAPI Structures