LINEOPERATORSTATUS

Send Feedback

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.

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

Pocket PC: Pocket PC 2002 and later.
Smartphone: Smartphone 2002 and later.
OS Versions: Windows CE 3.0 and later.
Header: Extapi.h.
Library: Cellcore.lib.

See Also

Extended TAPI Structures | LINEOPERATOR

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.