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 |