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 節所定義。 此欄位會設定為 WwanUiccAppTypeMf、 WwanUiccAppTypeMfSIM 或 WwanUiccAppTypeMfRUIM 應用程式類型的零 (0) 。
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 參考的數目。 換句話說， 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 |