WWAN_UICC_APP_INFO structure (wwan.h)

Article
02/27/2024

La structure WWAN_UICC_APP_INFO décrit des informations sur une application UICC.

Syntaxe

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;

Membres

AppType

Valeur WWAN_UICC_APP_TYPE qui spécifie le type de l’application UICC.

AppIdSize

Taille de l’ID d’application en octets, comme défini dans la section 8.3 de la spécification technique ETSI TS 102 221. Ce champ est défini sur zéro (0) pour les types d’applications WwanUiccAppTypeMf,WwanUiccAppTypeMfSIM ou WwanUiccAppTypeMfRUIM .

AppId[WWAN_UICC_APP_ID_MAX_LEN]

L’ID de l'application. Seuls les premiers octets AppIdSize sont significatifs. Si l’ID d’application est plus long que WWAN_UICC_APP_ID_MAX_LEN octets, AppIdSize spécifie la longueur réelle, mais seuls les premiers WWAN_UICC_APP_ID_MAX_LEN octets se trouvent dans ce champ. Ce champ est valide uniquement lorsque AppType n’est pas WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM ou WwanUiccAppTypeMfRUIM.

AppNameLength

Longueur, en caractères, du nom de l’application.

AppName[WWAN_UICC_APP_NAME_MAX_LEN]

Chaîne UTF-8 spécifiant le nom de l’application. La longueur de ce champ est spécifiée par AppNameLength. Si la longueur est supérieure ou égale à WWAN_UICC_APP_NAME_MAX_LEN octets, ce champ contient le premier WWAN_UICC_APP_NAME_MAX_LEN - 1 octet du nom. La chaîne est toujours terminée par null.

NumPins

Nombre de références de code confidentiel d’application. En d’autres termes, le nombre d’éléments de PinRef valides. Les applications sur un R-UIM virtuel n’ont pas de références de code confidentiel.

PinRef[WWAN_UICC_PINREF_MAX]

Tableau d’octets spécifiant les références de code confidentiel d’application pour cette application (clés pour PIN1 et éventuellement UPIN), comme défini dans la section 9.4.2 de la spécification technique ETSI TS 102 221. Dans le cas d’un carte de vérification unique ou d’un pilote MBB et/ou d’un modem qui ne prend pas en charge différentes clés d’application pour différentes applications, ce champ doit être 0x01.