estructura WWAN_UICC_APP_INFO (wwan.h)

Artículo
03/05/2024

La estructura WWAN_UICC_APP_INFO describe información sobre una aplicación UICC.

Sintaxis

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;

Miembros

AppType

Valor WWAN_UICC_APP_TYPE que especifica el tipo de la aplicación UICC.

AppIdSize

El tamaño del identificador de aplicación en bytes, tal como se define en la sección 8.3 de la especificación técnica ETSI TS 102 221. Este campo se establece en cero (0) para los tipos de aplicación WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM o WwanUiccAppTypeMfRUIM .

AppId[WWAN_UICC_APP_ID_MAX_LEN]

El id. de aplicación. Solo los primeros bytes appIdSize son significativos. Si el identificador de aplicación es mayor que WWAN_UICC_APP_ID_MAX_LEN bytes, AppIdSize especifica la longitud real, pero solo los primeros WWAN_UICC_APP_ID_MAX_LEN bytes se encuentran en este campo. Este campo solo es válido cuando AppType no es WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM o WwanUiccAppTypeMfRUIM.

AppNameLength

Longitud, en caracteres, del nombre de la aplicación.

AppName[WWAN_UICC_APP_NAME_MAX_LEN]

Cadena UTF-8 que especifica el nombre de la aplicación. La longitud de este campo se especifica mediante AppNameLength. Si la longitud es mayor o igual que WWAN_UICC_APP_NAME_MAX_LEN bytes, este campo contiene el primer WWAN_UICC_APP_NAME_MAX_LEN - 1 bytes del nombre. La cadena siempre termina en null.

NumPins

Número de referencias de PIN de aplicación. Es decir, el número de elementos de PinRef que son válidos. Las aplicaciones de una R-UIM virtual no tienen referencias de PIN.

PinRef[WWAN_UICC_PINREF_MAX]

Matriz de bytes que especifica las referencias de PIN de aplicación para esta aplicación (claves para PIN1 y posiblemente UPIN), tal como se define en la sección 9.4.2 de la especificación técnica ETSI TS 102 221. En el caso de una tarjeta de verificación única, o un controlador MBB o módem que no admite claves de aplicación diferentes para diferentes aplicaciones, este campo debe ser 0x01.