WWAN_UICC_APP_INFO 结构 (wwan.h)

  • 项目

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

指定 UICC 应用程序类型的 WWAN_UICC_APP_TYPE 值。

AppIdSize

ETSI TS 102 221 技术规范第 8.3 节中定义的应用程序 ID 的大小（以字节为单位）。 对于 WwanUiccAppTypeMf、WwanUiccAppTypeMfSIM 或 WwanUiccAppTypeMfRUIM 应用类型，此字段设置为零 ( 0) 。

AppId[WWAN_UICC_APP_ID_MAX_LEN]

应用程序 ID。 只有前 一个 AppIdSize 字节有意义。 如果应用程序 ID 长于 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 引用的数目。 换句话说，有效的 PinRef 元素数。 虚拟 R-UIM 上的应用程序没有 PIN 引用。

PinRef[WWAN_UICC_PINREF_MAX]

一个字节数组，指定此应用程序的应用程序 PIN 引用 (PIN1 的密钥，并且可能为 UPIN) 的密钥，如 ETSI TS 102 221 技术规范的第 9.4.2 节所定义。 如果单验证卡，或者 MBB 驱动程序和/或调制解调器不支持不同应用程序的不同应用程序密钥，则必须0x01此字段。

注解

此结构在 WWAN_UICC_APP_LIST 结构中使用。

以下常量在此结构的 Wwan.h 标头中定义。

#define WWAN_UICC_APP_ID_MAX_LEN 32
#define WWAN_UICC_APP_NAME_MAX_LEN 256
#define WWAN_UICC_PINREF_MAX 8

要求

要求 值
最低受支持的客户端 Windows 10 版本 1903
标头 wwan.h

另请参阅

MB UICC 应用程序和文件系统访问权限

OID_WWAN_UICC_APP_LIST

WWAN_UICC_APP_LIST

WWAN_UICC_APP_TYPE