struktur WWAN_UICC_APP_INFO (wwan.h)

Artikel
03/05/2024

Struktur WWAN_UICC_APP_INFO menjelaskan informasi tentang aplikasi UICC.

Sintaks

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;

Anggota

AppType

Nilai WWAN_UICC_APP_TYPE yang menentukan jenis aplikasi UICC.

AppIdSize

Ukuran ID aplikasi dalam byte, seperti yang didefinisikan dalam Bagian 8.3 dari spesifikasi teknis ETSI TS 102 221. Bidang ini diatur ke nol (0) untuk jenis aplikasi WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM, atau WwanUiccAppTypeMfRUIM .

AppId[WWAN_UICC_APP_ID_MAX_LEN]

ID aplikasi. Hanya byte AppIdSize pertama yang bermakna. Jika ID aplikasi lebih panjang dari WWAN_UICC_APP_ID_MAX_LEN byte, maka AppIdSize menentukan panjang aktual tetapi hanya byte WWAN_UICC_APP_ID_MAX_LEN pertama yang ada di bidang ini. Bidang ini hanya valid ketika AppType bukan WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM, atau WwanUiccAppTypeMfRUIM.

AppNameLength

Panjang, dalam karakter, dari nama aplikasi.

AppName[WWAN_UICC_APP_NAME_MAX_LEN]

String UTF-8 yang menentukan nama aplikasi. Panjang bidang ini ditentukan oleh AppNameLength. Jika panjangnya lebih besar dari atau sama dengan WWAN_UICC_APP_NAME_MAX_LEN byte, bidang ini berisi WWAN_UICC_APP_NAME_MAX_LEN pertama - 1 byte nama. String selalu dihentikan null.

NumPins

Jumlah referensi PIN aplikasi. Dengan kata lain, jumlah elemen PinRef yang valid. Aplikasi pada R-UIM virtual tidak memiliki referensi PIN.

PinRef[WWAN_UICC_PINREF_MAX]

Array byte yang menentukan referensi PIN aplikasi untuk aplikasi ini (kunci untuk PIN1 dan mungkin UPIN), seperti yang didefinisikan dalam Bagian 9.4.2 dari spesifikasi teknis ETSI TS 102 221. Dalam kasus kartu verifikasi tunggal, atau driver MBB dan/atau modem yang tidak mendukung kunci aplikasi yang berbeda untuk aplikasi yang berbeda, bidang ini harus 0x01.