Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The LINEOPERATORSTATUSstructure 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 lineGetCurrentOperatorand lineGetOperatorStatuscalls.

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 dwPreferredCountelements, of type LINEOPERATOR. The offsets of the addresses in the array are relative to the beginning of the LINEOPERATORSTATUSstructure.

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 dwAvailableCountelements, of type LINEOPERATOR. The offsets of the addresses in the array are relative to the beginning of the LINEOPERATORSTATUSstructure.

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