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

29
3.3.13 WANGetIMSI, WanGetImsi
加入者識別子 IMSI(International Mobile Subscriber Identity)を取得します。
[C++]
DWORD WANGetIMSI(
BYTE* szIMSI ,
DWORD* pdwLength
);
[Visual Basic]
Public Shared Function WanGetImsi(_
ByRef IMSI As String _
) AS Int32
[C#]
public static Int32 WanGetImsi(
out string IMSI
)
解説
本関数は、加入者識別子 IMSI(International Mobile Subscriber Identity)を取得します。
IMSI は、SIM カードに記録してあります。取得するには、以下の条件が必要です。
- SIM カードを挿入済
- PIN ロックを解除済
Device Emulatorでは、SIM.iniファイルで指定したIMSIを取得します。詳細は、SIM.iniを参照してくだ
さい。
パラメータ
szIMSI
加入者識別子 IMSI(International Mobile Subscriber Identity)を取得します。
NULL を指定すると、WAN_ERROR_BUFFER_ERROR が返ります。
pdwLength
[in]
szIMSI のバッファの長さを指定します。
指定したバッファの長さが必要とするバッファの長さを下回った場合は、
WAN_ERROR_BUFFER_ERROR が返ります。
[out]
取得した IMSI の文字列長+1 を取得します。
戻り値
以下の値を返します。
WAN_ERROR_SUCCES
: 正常終了
WAN_ERROR_NOSIM
: SIM 未挿入
WAN_ERROR_MODULE_NOT_READY
: モジュール未準備（電源 OFF）
WAN_ERROR_BADPARAM
: パラメータエラー
WAN_ERROR_OPERATION_NOT_ALLOW
: 操作未許可エラー