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

41
3.3.20 WANGetCurrentOperatorID, WanGetCurrentOperatorID
接続中のオペレータの ID 情報を取得します。
[C++]
DWORD WANGetCurrentOperator(
struct wan_OperatorInfo*
pOperatorInfo
,
DWORD*
pGPRS_Status
);
[Visual Basic]
Public Shared Function WanGetCurrentOperator(_
ByVal
pOperatorInfo
As WanOperatorInfo, _
ByRef
GPRS_Status
As Def.GprsStatus _
) AS Int32
[C#]
public static Int32 WanGetCurrentOperator(
out WanOperatorInfo
pOperatorInfo
,
out Def.GprsStatus
GPRS_Status
);
解説
本関数は、接続中のオペレータの ID 情報のみを取得します。
WANGetCurrentOperator関数に比べて、短時間での実行が可能です。
wan_OperatorInfo, WanOperatorInfo構造体のszNumNameNumName)のみ
を取得し、その他の
メンバにはNULLを格納します。
Device Emulator では、パラメータチェックを行い、常に WAN_GPRS_AVAILABLE を取得します。
パラメータ
pOperatorInfo
wan_OperatorInfo, WanOperatorInfo構造体を指定します。
pGPRS_Status
接続中のオペレータの情報を取得します。取得する値は、WANGetCurrentOperator関数を参照して
ください。
戻り値
以下の値を返します。
WAN_ERROR_SUCCES
: 正常終了
WAN_ERROR_NOSIM
: SIM 未挿入
WAN_ERROR_MODULE_NOT_READY
: モジュール未準備(電源 OFF
WAN_ERROR_BADPARAM
: パラメータエラー
WAN_ERROR_OPERATION_NOT_ALLOW
: 操作未許可エラー
WAN_ERROR_NO_OPERATOR
: オペレータ非存在
DeviceEmulator では発生しません
WAN_ERROR_FAIL
: その他のエラー
DeviceEmulator では発生しません