WWAN_UICC_APP_INFO-Struktur (wwan.h)
Die WWAN_UICC_APP_INFO-Struktur beschreibt Informationen zu einer UICC-Anwendung.
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;
Member
AppType
Ein WWAN_UICC_APP_TYPE Wert, der den Typ der UICC-Anwendung angibt.
AppIdSize
Die Größe der Anwendungs-ID in Bytes gemäß Abschnitt 8.3 der technischen Spezifikation ETSI TS 102 221. Dieses Feld ist für die App-Typen WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM oder WwanUiccAppTypeMfRUIM auf Null (0) festgelegt.
AppId[WWAN_UICC_APP_ID_MAX_LEN]
Die Anwendungs-ID. Nur die ersten AppIdSize-Bytes sind sinnvoll. Wenn die Anwendungs-ID länger als WWAN_UICC_APP_ID_MAX_LEN Bytes ist, gibt AppIdSize die tatsächliche Länge an, aber nur die ersten WWAN_UICC_APP_ID_MAX_LEN Bytes befinden sich in diesem Feld. Dieses Feld ist nur gültig, wenn AppType nicht WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM oder WwanUiccAppTypeMfRUIM ist.
AppNameLength
Die Länge des Anwendungsnamens in Zeichen.
AppName[WWAN_UICC_APP_NAME_MAX_LEN]
Eine UTF-8-Zeichenfolge, die den Namen der Anwendung angibt. Die Länge dieses Felds wird von AppNameLength angegeben. Wenn die Länge größer oder gleich WWAN_UICC_APP_NAME_MAX_LEN Bytes ist, enthält dieses Feld den ersten WWAN_UICC_APP_NAME_MAX_LEN – 1 Byte des Namens. Die Zeichenfolge ist immer NULL-beendet.
NumPins
Die Anzahl der Anwendungs-PIN-Verweise. Mit anderen Worten, die Anzahl der gültigen PinRef-Elemente . Anwendungen auf einem virtuellen R-UIM weisen keine PIN-Verweise auf.
PinRef[WWAN_UICC_PINREF_MAX]
Ein Bytearray, das die Anwendungs-PIN-Verweise für diese Anwendung angibt (Schlüssel für PIN1 und möglicherweise UPIN), wie in Abschnitt 9.4.2 der technischen Spezifikation ETSI TS 102 221 definiert. Im Falle eines einmaligen Karte oder eines MBB-Treibers und/oder Modems, das keine unterschiedlichen Anwendungsschlüssel für verschiedene Anwendungen unterstützt, muss dieses Feld 0x01 werden.
Hinweise
Diese Struktur wird in der WWAN_UICC_APP_LIST-Struktur verwendet.
Die folgenden Konstanten werden im Wwan.h-Header für diese Struktur definiert.
#define WWAN_UICC_APP_ID_MAX_LEN 32
#define WWAN_UICC_APP_NAME_MAX_LEN 256
#define WWAN_UICC_PINREF_MAX 8
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1903 |
| Kopfzeile | wwan.h |