WWAN_UICC_APP_INFO 構造体 (wwan.h)

[アーティクル]
08/08/2023

WWAN_UICC_APP_INFO構造体は、UICC アプリケーションに関する情報を記述します。

構文

typedef struct _WWAN_UICC_APP_INFO {
  WWAN_UICC_APP_TYPE AppType;
  ULONG              AppIdSize;
  BYTE               AppId[WWAN_UICC_APP_ID_MAX_LEN];
  ULONG              AppNameLength;
  BYTE               AppName[WWAN_UICC_APP_NAME_MAX_LEN];
  ULONG              NumPins;
  BYTE               PinRef[WWAN_UICC_PINREF_MAX];
} WWAN_UICC_APP_INFO, *PWWAN_UICC_APP_INFO;

メンバー

AppType

UICC アプリケーションの種類 を指定するWWAN_UICC_APP_TYPE値。

AppIdSize

ETSI TS 102 221 技術仕様のセクション 8.3 で定義されているアプリケーション ID のサイズ (バイト単位)。このフィールドは、WwanUiccAppTypeMf、WwanUiccAppTypeMfSIM、または WwanUiccAppTypeMfRUIM アプリの種類に対して 0 に設定されます。

AppId[WWAN_UICC_APP_ID_MAX_LEN]

アプリケーション ID。最初の AppIdSize バイトのみが意味があります。アプリケーション ID が WWAN_UICC_APP_ID_MAX_LEN バイトより長い場合、 AppIdSize は実際の長さを指定しますが、このフィールドには最初 のWWAN_UICC_APP_ID_MAX_LEN バイトのみが含まれます。このフィールドは、AppType が WwanUiccAppTypeMf、WwanUiccAppTypeMfSIM、または WwanUiccAppTypeMfRUIM でない場合にのみ有効です。

AppNameLength

アプリケーション名の長さ (文字数)。

AppName[WWAN_UICC_APP_NAME_MAX_LEN]

アプリケーションの名前を指定する UTF-8 文字列。このフィールドの長さは AppNameLength で指定します。長さが WWAN_UICC_APP_NAME_MAX_LEN バイト以上の場合、このフィールドには名前の最初の WWAN_UICC_APP_NAME_MAX_LEN - 1 バイトが含まれます。文字列は常に null で終了します。

NumPins

アプリケーション PIN 参照の数。つまり、 有効な PinRef の要素の数です。仮想 R-UIM 上のアプリケーションには PIN 参照がありません。

PinRef[WWAN_UICC_PINREF_MAX]

ETSI TS 102 221 技術仕様のセクション 9.4.2 で定義されているように、このアプリケーションのアプリケーション PIN 参照 (PIN1 および場合によっては UPIN のキー) を指定するバイト配列。単一検証カードの場合、またはアプリケーションごとに異なるアプリケーションキーをサポートしていない MBB ドライバーやモデムの場合は、このフィールドを0x01する必要があります。