структура WWAN_UICC_APP_INFO (wwan.h)

Статья
02/07/2025

Структура 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

Значение WWAN_UICC_APP_TYPE, указывающее тип приложения UICC.

AppIdSize

Размер идентификатора приложения в байтах, как определено в разделе 8.3 технической спецификации ETSI TS 102 221. Это поле равно нулю (0) для WwanUiccAppTypeMf, WwanUiccAppTypeMfSIMили типов приложений WwanUiccAppTypeMfRUIM.

AppId[WWAN_UICC_APP_ID_MAX_LEN]

Идентификатор приложения. Важны только первые AppIdSize байт. Если идентификатор приложения больше 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 Ref. Приложения на виртуальном языке R-UIM не имеют ссылок на ПИН-коды.

PinRef[WWAN_UICC_PINREF_MAX]

Массив байтов, указывающий ссылки на ПИН-код приложения для этого приложения (ключи для PIN1 и, возможно, UPIN), как определено в разделе 9.4.2 технической спецификации ETSI TS 102 221. В случае с одной картой проверки или драйвером MBB и (или) модемом, который не поддерживает разные ключи приложений для разных приложений, это поле должно быть 0x01.