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 |