struttura WWAN_UICC_APP_INFO (wwan.h)

Articolo
02/07/2025

La struttura WWAN_UICC_APP_INFO descrive le informazioni su un'applicazione UICC.

Sintassi

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;

Membri

AppType

Valore WWAN_UICC_APP_TYPE che specifica il tipo dell'applicazione UICC.

AppIdSize

Dimensioni dell'ID applicazione in byte, come definito nella sezione 8.3 della specifica tecnica ETSI TS 102 221. Questo campo è impostato su zero (0) per il WwanUiccAppTypeMf, WwanUiccAppTypeMfSIMo WwanUiccAppTypeMfRUIM tipi di app.

AppId[WWAN_UICC_APP_ID_MAX_LEN]

ID applicazione. Solo il primo AppIdSize byte è significativo. Se l'ID applicazione è più lungo di WWAN_UICC_APP_ID_MAX_LEN byte, AppIdSize specifica la lunghezza effettiva, ma solo i primi byte WWAN_UICC_APP_ID_MAX_LEN si trovano in questo campo. Questo campo è valido solo quando AppType non è WwanUiccAppTypeMf, WwanUiccAppTypeMfSIMo WwanUiccAppTypeMfRUIM.

AppNameLength

Lunghezza, in caratteri, del nome dell'applicazione.

AppName[WWAN_UICC_APP_NAME_MAX_LEN]

Stringa UTF-8 che specifica il nome dell'applicazione. La lunghezza di questo campo viene specificata da AppNameLength. Se la lunghezza è maggiore o uguale a WWAN_UICC_APP_NAME_MAX_LEN byte, questo campo contiene il primo WWAN_UICC_APP_NAME_MAX_LEN - 1 byte del nome. La stringa è sempre con terminazione Null.

NumPins

Numero di riferimenti al PIN dell'applicazione. In altre parole, il numero di elementi di PinRef validi. Le applicazioni in un R-UIM virtuale non hanno riferimenti PIN.

PinRef[WWAN_UICC_PINREF_MAX]

Matrice di byte che specifica i riferimenti al PIN dell'applicazione per questa applicazione (chiavi per PIN1 ed eventualmente UPIN), come definito nella sezione 9.4.2 della specifica tecnica ETSI TS 102 221. Nel caso di una scheda di verifica singola o di un driver MBB e/o di un modem che non supporta chiavi dell'applicazione diverse per applicazioni diverse, questo campo deve essere 0x01.