Share via


LINEOPERATORSTATUS

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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
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
LINEOPERATOR