Share via


LINEOPERATORSTATUS (Compact 2013)

3/26/2014

The LINEOPERATORSTATUS structure holds the set of preferred and available operators. The preferred operator list is stored locally on the device and automatic registration iterates through this list when attempting to register. The available list shows which network operators are currently in range of the device. This structure is used with lineGetCurrentOperator and lineGetOperatorStatus calls.

Syntax

typedef struct lineoperatorstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwPreferredCount;
  DWORD dwPreferredSize;
  DWORD dwPreferredOffset;
  DWORD dwAvailableCount;
  DWORD dwAvailableSize;
  DWORD dwAvailableOffset;
} LINEOPERATORSTATUS, * LPLINEOPERATORSTATUS;

Members

  • dwTotalSize
    The total size in bytes allocated to this data structure.
  • dwNeededSize
    The size, in bytes, of this data structure, which is required to hold all of the returned information.
  • dwUsedSize
    The size, in bytes, of the portion of this data structure that contains useful information.
  • dwPreferredCount
    Number of entries in the preferred operator list.
  • dwPreferredSize
    The size, in bytes, of the variably sized field that describes the preferred operators.
  • dwPreferredOffset
    The size, in bytes, of the variably sized field that describes the preferred operators and the offset, in bytes, from the beginning of this data structure. This information is an array of dwPreferredCount elements, of type LINEOPERATOR. The offsets of the addresses in the array are relative to the beginning of the LINEOPERATORSTATUS structure.
  • dwAvailableCount
    Number of operators currently available.
  • dwAvailableSize
    The size, in bytes, of the variably sized field that describes the available operators.
  • dwAvailableOffset
    The size, in bytes, of the variably sized field that describes the available operators and the offset, in bytes, from the beginning of this data structure. This information is an array of dwAvailableCount elements, of type LINEOPERATOR. The offsets of the addresses in the array are relative to the beginning of the LINEOPERATORSTATUS structure.

Requirements

Header

extapi.h

See Also

Reference

Extended TAPI Structures
LINEOPERATOR