WWAN_UICC_ACCESS_BINARY-Struktur (wwan.h)

Artikel
02/27/2024

Die WWAN_UICC_ACCESS_BINARY-Struktur beschreibt Informationen zu einer UICC-Binärdatei, die gelesen werden soll oder in die geschrieben werden soll.

Syntax

typedef struct _WWAN_UICC_ACCESS_BINARY {
  ULONG               Version;
  BYTE                AppId[WWAN_UICC_APP_ID_MAX_LEN];
  WWAN_UICC_FILE_PATH UiccFilePath;
  ULONG               FileOffset;
  ULONG               NumberOfBytes;
  BYTE                LocalPinSize;
  BYTE                LocalPin[WWAN_PIN_LEN];
  USHORT              BinaryDataSize;
  BYTE                BinaryData[ANYSIZE_ARRAY];
} WWAN_UICC_ACCESS_BINARY, *PWWAN_UICC_ACCESS_BINARY;

Member

Version

Die Versionsnummer der folgenden Struktur. In Windows 10 Version 1903 muss diese Version auf 1 festgelegt werden.

AppId[WWAN_UICC_APP_ID_MAX_LEN]

Die Anwendungs-ID.

UiccFilePath

Eine formatierte WWAN_UICC_FILE_PATH Struktur, die den Dateipfad der UICC-Binärdatei beschreibt.

FileOffset

Der Offset, der beim Lesen aus der Datei verwendet werden soll. Dieses Feld kann größer als 256 sein und kombiniert sowohl offset high als auch offset low gemäß der technischen Spezifikation ETSI TS 102 221.

NumberOfBytes

Die Anzahl der zu lesenden Bytes. Beispielsweise könnte ein Clienttreiber diese Funktion verwenden, um eine transparente (Binärdatei) zu lesen, die größer als 256 Bytes ist, obwohl die maximale Menge, die in einem einzelnen UICC-Vorgang gelesen oder geschrieben werden kann, 256 Bytes gemäß der technischen Spezifikation von ETSI TS 102 221 beträgt. Es liegt in der Verantwortung der Funktion, dies in mehrere APDUs aufzuteilen und das Ergebnis in einer einzigen Antwort zurückzusenden.

LocalPinSize

Die Größe des Kennworts in Bytes.

LocalPin[WWAN_PIN_LEN]

Das Kennwort für die UICC.

BinaryDataSize

Die Größe der Binärdaten in Bytes.

BinaryData[ANYSIZE_ARRAY]

Wird nur in Set-Vorgängen (Schreibvorgängen) verwendet. Enthält die Daten, die in die Datei geschrieben werden sollen.

Hinweise

Diese Struktur wird in der NDIS_WWAN_UICC_ACCESS_BINARY-Struktur verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1903
Kopfzeile	wwan.h

Weitere Informationen

MB UICC-Anwendungs- und Dateisystemzugriff

OID_WWAN_UICC_ACCESS_BINARY

NDIS_WWAN_UICC_ACCESS_BINARY

Freigeben über