WWAN_UICC_APP_INFO構造体 (wwan.h)
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する必要があります。
備考
この構造体は、WWAN_UICC_APP_LIST 構造体で使用されます。
この構造体の Wwan.h ヘッダーには、次の定数が定義されています。
#define WWAN_UICC_APP_ID_MAX_LEN 32
#define WWAN_UICC_APP_NAME_MAX_LEN 256
#define WWAN_UICC_PINREF_MAX 8
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 10 バージョン 1903 |
| ヘッダー | wwan.h |
関連項目
MB UICC アプリケーションとファイル システム アクセス を する