Edit

WWAN_UICC_ACCESS_BINARY structure (wwan.h)

  • Article

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 {
  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;

Members

Version

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

AppId[WWAN_UICC_APP_ID_MAX_LEN]

The application ID.

UiccFilePath

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

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.

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.

LocalPinSize

The size of the password, in bytes.

LocalPin[WWAN_PIN_LEN]

The password for the UICC.

BinaryDataSize

The size of the binary data, in bytes.

BinaryData[ANYSIZE_ARRAY]

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

Requirement Value
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