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

See Also

Reference

Extended TAPI Structures
LINEOPERATOR