User manual - WANGPRSライブラリマニュアルver.1.04(2014年2月12日)

34
3.3.16 WANGetOperatorList, WanGetOperatorList
オペレータリストを取得します。
[C++]
DWORD WANGetOperatorList(
struct wan_OperatorInfo* pOperatorList ,
DWORD nOperator ,
DWORD* pdwNumOperator
)
[Visual Basic]
Public Shared Function WanGetOperatorList(_
ByRef pOperatorList () As WanOperatorInfo, _
ByVal Operator As Int32 _
) AS Int32
[C#]
public static Int32 WanGetOperatorList(
out WanOperatorInfo[] pOperatorList ,
Int32 Operator
)
解説
本関数は、オペレータリストを取得します。
基地局をスキャンし、現在接続可能な基地局のリストを返します。スキャンした基地局が指定した要素
数より多い場合は、WAN_ERROR_MORE_OPERATORを返します。その場合は、指定した要素数まで、
基地局情報を格納し、pdwNumOperator にスキャンした基地局数を格納します。
また、本関数はスキャンが終了するまで制御が返りません。
Device Emulatorでは、OperatorList[n].iniファイル数だけスキャンを行い、iniファイルで指定した情
報を取得します。詳細は、OperatorList[n].iniを参照
してください。
パラメータ
pOperatorList
wan_OperatorInfo, WanOperatorInfo構造体の配列を指定します。
nOperator
取得する要素数を指定します。
pdwNumOperator
スキャンした要素数を取得します。
戻り値
以下の値を返します。
WAN_ERROR_SUCCES
: 正常終了
WAN_ERROR_NOSIM
: SIM 未挿入
WAN_ERROR_MODULE_NOT_READY
: モジュール未準備（電源 OFF）
WAN_ERROR_BADPARAM
: パラメータエラー