WWAN_UICC_APP_INFO structure (wwan.h)
The WWAN_UICC_APP_INFO structure describes information about a UICC application.
Syntax
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;
Members
AppType
A WWAN_UICC_APP_TYPE value that specifies the type of the UICC application.
AppIdSize
The size of the application ID in bytes, as defined in Section 8.3 of the ETSI TS 102 221 technical specification. This field is set to zero (0) for the WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM, or WwanUiccAppTypeMfRUIM app types.
AppId[WWAN_UICC_APP_ID_MAX_LEN]
The application ID. Only the first AppIdSize bytes are meaningful. If the application ID is longer than WWAN_UICC_APP_ID_MAX_LEN bytes, then AppIdSize specifies the actual length but only the first WWAN_UICC_APP_ID_MAX_LEN bytes are in this field. This field is valid only when AppType is not WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM, or WwanUiccAppTypeMfRUIM.
AppNameLength
The length, in characters, of the application name.
AppName[WWAN_UICC_APP_NAME_MAX_LEN]
A UTF-8 string specifying the name of the application. The length of this field is specified by AppNameLength. If the length is greater than or equal to WWAN_UICC_APP_NAME_MAX_LEN bytes, this field contains the first WWAN_UICC_APP_NAME_MAX_LEN - 1 bytes of the name. The string is always null-terminated.
NumPins
The number of application PIN references. In other words, the number of elements of PinRef that are valid. Applications on a virtual R-UIM have no PIN references.
PinRef[WWAN_UICC_PINREF_MAX]
A byte array specifying the application PIN references for this application (keys for PIN1 and possibly UPIN), as defined in Section 9.4.2 of the ETSI TS 102 221 technical specification. In the case of a single-verification card, or an MBB driver and/or modem that does not support different application keys for different applications, this field must be 0x01.
Remarks
This structure is used in the WWAN_UICC_APP_LIST structure.
The following constants are defined in the Wwan.h header for this structure.
#define WWAN_UICC_APP_ID_MAX_LEN 32
#define WWAN_UICC_APP_NAME_MAX_LEN 256
#define WWAN_UICC_PINREF_MAX 8
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1903 |
| Header | wwan.h |