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

Статья
08/08/2023

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

Количество ссылок на ПИН-код приложения. Другими словами, количество допустимых элементов PinRef . Приложения на виртуальной R-UIM не имеют ссылок на ПИН-коды.

PinRef[WWAN_UICC_PINREF_MAX]

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