WWAN_UICC_ACCESS_BINARY structure

The WWAN_UICC_ACCESS_BINARY structure describes information about a UICC binary file to read or to which to write.

Syntax

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

Members

UiccFilePath

A formatted WWAN_UICC_FILE_PATH structure that describes the file path of the UICC binary file.

Version

The version number of the structure that follows. In Windows 10, version 1903, this version must be set to 1.

AppId

The application ID.

NumberOfBytes

The number of bytes to be read. For example, a client driver could use this function to read a transparent (binary) file that is larger than 256 bytes, although the maximum amount that can be read or written in a single UICC operation is 256 bytes per the ETSI TS 102 221 technical specification. It is the function's responsibility to split this into multiple APDUs and send the result back in a single response.

FileOffset

The offset to use when reading from the file. This field can be bigger than 256, and it combines both offset high and offset low as defined in the ETSI TS 102 221 technical specification.

LocalPin

The password for the UICC.

LocalPinSize

The size of the password, in bytes.

BinaryDataSize

The size of the binary data, in bytes.

BinaryData

Used only in Set (write) operations. Contains the data to write to the file.

Remarks

This structure is used in the NDIS_WWAN_UICC_ACCESS_BINARY structure.

Requirements

   
Minimum supported client Windows 10, version 1903
Header wwan.h

See Also

MB UICC application and file system access

OID_WWAN_UICC_ACCESS_BINARY

NDIS_WWAN_UICC_ACCESS_BINARY