Delen via

TOEGANG tot UICC-toepassingen en -bestandssysteem in MB

  • Artikel

Overzicht

In dit onderwerp wordt een extensie opgegeven voor de MBIM-interface (Mobile Broadband Interface Model) om toegang te verlenen tot de UICC-smartcardtoepassing en -bestandssystemen. Deze extensie voor MBIM biedt logische toegang tot de technische specificatie van de UICC-ETSI TS 102 221-compatibele toepassingen en bestandssysteem, en wordt ondersteund in Windows 10, versie 1903 en hoger.

UICC-toegang en -beveiliging

UiCC biedt een bestandssysteem en ondersteunt een set toepassingen die gelijktijdig kunnen worden uitgevoerd. Dit zijn de USIM voor UMTS, CSIM voor CDMA en ISIM voor IMS. De SIM is een verouderd gedeelte van de UICC dat kan worden gemodelleerd als een van deze toepassingen (voor GSM).

Het volgende diagram in sectie 8.1 van de technische specificatie ETSI TS 102 221 toont een voorbeeld van een kaarttoepassingsstructuur.

diagram met een voorbeeld van een UICC-toepassingsstructuur.

Het UICC-bestandssysteem kan worden beschouwd als een bos van mappenstructuren. De verouderde SIM-boomstructuur is geroot op een masterbestand (MF) en bevat maximaal twee niveaus van submappen (Toegewezen bestanden of BESTANDEN) die Elemental Files (EFs) bevatten die verschillende soorten informatie bevatten. De SIM definieert DFs onder het MF, waarvan een, DFTelecom, informatie bevat die gebruikelijk is voor meerdere toegangstypen, zoals het algemene telefoonboek. Aanvullende toepassingen worden effectief geïmplementeerd als afzonderlijke bomen, die elk zijn geroot in een eigen ADF (Application Directory File). Elke ADF wordt geïdentificeerd door een toepassings-id die maximaal 128 bits lang kan zijn. Een bestand onder de kaarthoofdmap (EFDir onder de MF in het diagram) bevat de toepassingsnamen en bijbehorende id's. Binnen een boomstructuur (de MF of een ADF) kunnen DFS en EFS worden geïdentificeerd door een pad van bestands-id's, waarbij een bestands-id een 16-bits geheel getal is.

NDIS-interface-extensies

De volgende OID's zijn gedefinieerd ter ondersteuning van UICC-toepassings- en bestandssysteemtoegang.

MBIM-service en CID-waarden

Servicenaam UUID UUID-waarde
Microsoft Low-Level UICC Access UUID_MS_UICC_LOW_LEVEL C2F6588E-F037-4BC9-8665-F4D44BD09367
Microsoft Basic IP-connectiviteitsextensies UUID_BASIC_CONNECT_EXTENSIONS 3D01DCC5-FEF5-4D05-9D3A-BEF7058E9AAF

De volgende tabel geeft de UUID en opdrachtcode voor elke CID, evenals of de CID ondersteuning biedt voor aanvragen voor instellen, query's of gebeurtenissen (meldingen). Zie de afzonderlijke sectie van elke CID in dit onderwerp voor meer informatie over de parameters, gegevensstructuren en meldingen.

CID UUID Opdrachtcode Set Zoekopdracht Aankondigen
MBIM_CID_MS_UICC_APP_LIST UUID_MS_UICC_LOW_LEVEL 7 N Y N
MBIM_CID_MS_UICC_FILE_STATUS UUID_MS_UICC_LOW_LEVEL 8 N Y N
MBIM_CID_MS_UICC_ACCESS_BINARY UUID_MS_UICC_LOW_LEVEL 9 Y Y N
MBIM_CID_MS_UICC_ACCESS_RECORD UUID_MS_UICC_LOW_LEVEL 10 Y Y N
MBIM_CID_MS_PIN_EX UUID_BASIC_CONNECT_EXTENSIONS 14 Y Y N

MBIM_CID_MS_UICC_APP_LIST

Deze CID haalt een lijst met toepassingen op in een UICC en informatie over deze toepassingen. Wanneer de UICC in de modem volledig is geïnitialiseerd en klaar is om te worden geregistreerd bij de mobiele provider, moet een UICC-toepassing worden geselecteerd voor registratie en moet een query met deze CID de geselecteerde toepassing retourneren in het veld ActiveAppIndex- in de MBIM_UICC_APP_LIST structuur die als reactie wordt gebruikt.

Parameters

Operatie Set Vraag Melding
Bevelen Niet van toepassing Leeg Niet van toepassing
Antwoord Niet van toepassing MBIM_UICC_APP_LIST Niet van toepassing

Vraag

De InformationBuffer van MBIM_COMMAND_MSG is leeg.

Set

Niet van toepassing.

Antwoord

De InformationBuffer in MBIM_COMMAND_DONE bevat de volgende MBIM_UICC_APP_LIST structuur.

MBIM_UICC_APP_LIST (versie 1)

Afstand Grootte Veld Soort Beschrijving
0 4 Versie UINT32 Het versienummer van de structuur die volgt. Dit veld moet worden ingesteld op 1 voor versie 1 van deze structuur.
4 4 AppCount UINT32 Het aantal structuren van UICC-toepassingen MBIM_UICC_APP_INFO die worden geretourneerd in dit antwoord.
8 4 ActiveAppIndex UINT32(0..NumApp - 1) De index van de toepassing die door de modem is geselecteerd voor registratie bij het mobiele netwerk. Dit veld moet tussen 0 en de AppCount - 1zijn. Het indexeert de array van applicaties die door deze respons worden geretourneerd. Als er geen toepassing is geselecteerd voor registratie, bevat dit veld 0xFFFFFFFF.
12 4 App-lijstgrootte UINT32 De grootte van de lijstgegevens van de app, in bytes.
8*AppCount AppLijst OL_PAIR_LIST Het eerste element van het paar is een veld met vier bytes met de offset van een app-informatie in de DataBuffer. Het tweede element van het paar is een veld met vier bytes met de grootte van de app-informatie.
AppListSize DataBuffer gegevensbuffer Een matrix van AppCount * MBIM_UICC_APP_INFO structuren.

MBIM_UICC_APP_INFO

Compensatie Grootte Veld Type Beschrijving
0 4 AppType MBIM_UICC_APP_TYPE Het type UICC-toepassing.
4 4 AppIdOffset VERSCHUIVING Verschuiving voor de applicatie-ID in de gegevensbuffer. Alleen de eerste AppIdSize-bytes zijn zinvol. Als de toepassings-id langer is dan MBIM_MAXLENGTH_APPID bytes, geeft AppIdSize de werkelijke lengte op, maar alleen de eerste MBIM_MAXLENGTH_APPID bytes zijn in dit veld. Dit veld is alleen geldig als AppType niet MBIMUiccAppTypeMf, MBIMUiccAppTypeMfSIM of MBIMUiccAppTypeMfRUIM is.
8 4 AppIdSize GROOTTE (0..16) De grootte van de toepassings-id, in bytes, zoals gedefinieerd in sectie 8.3 van de technische specificatie etSI TS 102 221. AppIdSize kan een getal groter dan 16 bevatten, maar in dit geval staan alleen de eerste 16 (MBIM_MAXLENGTH_APPID) bytes in de databuffer. Dit veld is ingesteld op nul voor de app-typen MBIMUiccAppTypeMf, MBIMUiccAppTypeMfSIM of MBIMUiccAppTypeMfRUIM.
12 AppNameOffset VERZET Offset voor de naam van de toepassing in de databuffer. Een UTF-8-tekenreeks die de naam van de toepassing opgeeft. De lengte van dit veld wordt opgegeven door AppNameLength. Als de lengte groter is dan of gelijk is aan MBIM_MAXLENGTH_APPNAME bytes, bevat dit veld de eerste MBIM_MAXLENGTH_APPNAME - 1 bytes van de naam. De tekenreeks is altijd null-beëindigd.
16 4 AppNameLength GROOTTE (0..256) De lengte, in bytes, van de naam van de toepassing. AppNameLength kan een getal bevatten dat gelijk is aan of groter is dan 256, maar in deze gevallen bevinden zich alleen de eerste 255 (MBIM_MAXLENGTH_APPNAME - 1) bytes in de databuffer.
20 4 NumPinKeyRefs Grootte (0..8) Het aantal referenties voor de pincode van de toepassing. Met andere woorden, het aantal elementen van PinKeyRef dat geldig is. Toepassingen op een virtuele R-UIM hebben geen verwijzingen naar pincodes.
24 4 KeyRefOffset VERSCHUIVING Verschuiving van de PinKeyRef in de DataBuffer. De PinKeyRef is een bytematrix die de pincodeverwijzingen van de toepassing opgeeft voor verschillende verificatieniveaus (sleutels voor PIN1, PIN2 en mogelijk een universele pincode), zoals gedefinieerd in tabel 9.3 en sectie 9.4.2 van de technische specificatie van ETSI TS 102 221. In het geval van een kaart met één verificatie of een MBB-stuurprogramma en/of modem die geen verschillende toepassingssleutels voor verschillende toepassingen ondersteunt, moet de eerste byte van het veld PinKeyRef worden 0x01 (PIN1) en moet de tweede byte 0x81 (PIN2), zoals beschreven in sectie 9.5.1 van ETSI TS 102 221.
28 4 KeyRefSize GROOTTE (0..8) De grootte van PinKeyRef.
32 DataBuffer DATABUFFER De gegevensbuffer met AppId, AppName en PinKeyRef van een kaart voor enkelvoudige verificatie, of van een MBB-stuurprogramma en/of modem dat geen ondersteuning biedt voor verschillende toepassingssleutels voor verschillende toepassingen, moet het veld 0x01zijn.

MBIM_UICC_APP_TYPE

Soort Waarde Beschrijving
MBIMUiccAppTypeOnbekend 0 Onbekend type.
MBIMUiccAppTypeMf 1 Verouderde SIM-directories die zijn verankerd aan het MF.
MBIMUiccAppTypeMfSIM 2 Verouderde SIM-mappen die zich bij DF_GSM bevinden.
MBIMUiccAppTypeMfRUIM 3 Verouderde SIM-mappen die zijn gebaseerd op DF_CDMA.
MBIMUiccAppTypeUSIM 4 USIM-toepassing.
MBIMUiccAppTypeCSIM 5 CSIM-toepassing.
MBIMUiccAppTypeISIM 6 ISIM-toepassing.

Constanten

De volgende constanten worden gedefinieerd voor MBIM_CID_MS_UICC_APP_INFO.

const int MBIM_MAXLENGTH_APPID = 32
const int MBIM_MAXLENGTH_APPNAME = 256
const int MBIM_MAXNUM_PINREF = 8

Ongevraagde gebeurtenissen

Niet van toepassing.

Statuscodes

De volgende statuscodes zijn van toepassing:

Statuscode Beschrijving
MBIM_STATUS_SUCCESS Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_BUSY Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_FAILURE Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_NO_DEVICE_SUPPORT Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_SIM_NIET_INGEVOERD Kan de UICC-bewerking niet uitvoeren omdat de UICC ontbreekt.
MBIM_STATUS_ONGEDEUGDE_SIM Kan de UICC-bewerking niet uitvoeren omdat de UICC een foutstatus heeft.
MBIM-status niet geïnitieerd Kan de UICC-bewerking niet uitvoeren omdat de UICC nog niet volledig is geïnitialiseerd.

MBIM_CID_MS_UICC_FILE_STATUS

Met deze CID wordt informatie opgehaald over een opgegeven UICC-bestand.

Parameters

Operatie Set Vraag Melding
Bevelen Niet van toepassing MBIM_UICC_FILE_PATH Niet van toepassing
Antwoord Niet van toepassing MBIM_UICC_FILE_STATUS Niet van toepassing

Vraag

De Information-Buffer van MBIM_COMMAND_MSG bevat het doel EF als een MBIM_UICC_FILE_PATH-structuur.

MBIM_UICC_FILE_PATH (versie 1)

Afstand Grootte Veld Type Beschrijving
0 4 Versie UINT32 Het versienummer van de structuur die volgt. Dit veld moet 1 zijn voor versie 1 van deze structuur.
4 4 AppIdOffset VERSCHUIVING De offset, in bytes, berekend vanaf het begin van deze structuur naar de buffer die de toepassings-id bevat.
8 4 AppIdSize GROOTTE (0..16) De grootte van de toepassings-id, in bytes, zoals gedefinieerd in sectie 8.3 van het ETSI TS 102 221 technische specificatie. Voor 2G-kaarten moet dit veld worden ingesteld op nul (0).
12 4 FilePathOffset VERSCHUIVING De offset, in bytes, berekend vanaf het begin van deze structuur naar de buffer die het bestandspad bevat. Het bestandspad is een matrix van 16-bits bestands-id's. De eerste id moet 0x7FFF of 0x3F00zijn. Als de eerste id 0x7FFFis, dan is het pad relatief aan de ADF van de toepassing die is toegewezen door AppId. Anders is het een absoluut pad vanaf de MF.
16 4 FilePathSize GROOTTE (0..8) De grootte van het bestandspad, in bytes.
20 Gegevensbuffer DATABUFFER De gegevensbuffer met AppId en FilePath.

Instellen

Niet van toepassing.

Antwoord

De volgende MBIM_UICC_FILE_STATUS structuur wordt gebruikt in de InformationBuffer.

MBIM_UICC_FILE_STATUS (versie 1)

Afstand Grootte Veld Type Beschrijving
0 4 Versie UINT32 Het versienummer van de structuur die volgt. Dit veld moet 1 zijn voor versie 1 van deze structuur.
4 4 StatusWord1 UINT32(0..256) Een retourparameter die specifiek is voor de UICC-opdracht.
8 4 StatusWord2 UINT32(0..256) Een retourparameter die specifiek is voor de UICC-opdracht.
12 4 Bestandstoegankelijkheid MBIM_UICC_FILE_ACCESSIBILITY De toegankelijkheid van het UICC-bestand.
16 4 FileType MBIM_UICC_FILE_TYPE Het UICC-bestandstype.
20 4 FileStructure MBIM_UICC_FILE_STRUCTURE De UICC-bestandsstructuur.
24 4 AantalItems UINT32 Het aantal items in het UICC-bestand. Voor transparante en TLV-bestanden is dit ingesteld op 1.
28 4 Grootte UINT32 De grootte van elk item, in bytes. Voor transparante of TLV-bestanden is dit de grootte van de gehele EF. Voor op records gebaseerde bestanden vertegenwoordigt dit het totale aantal records.
32 16 FileLockStatus MBIM_PIN_TYPE_EX[4] Een matrix van het type MBIM_PIN_TYPE_EX die de toegangsvoorwaarde beschrijft voor elke bewerking (LEZEN, BIJWERKEN, ACTIVEREN en DEACTIVEREN in die volgorde) in dat bestand.

MBIM_UICC_FILE_ACCESSIBILITY

De opsomming MBIM_UICC_FILE_ACCESSIBILITY wordt gebruikt in de voorgaande MBIM_UICC_FILE_STATUS structuur.

Type Waarde Beschrijving
MBIMUiccFileAccessibilityUnknown 0 Deelbaarheid van bestand onbekend.
MBIMUiccFileAccessibilityNietDeelbaar 1 Het bestand kan niet worden gedeeld.
MBIMUiccFileAccessibilityShareable 2 Deelbaar bestand.

MBIM_UICC_FILE_TYPE

De opsomming MBIM_UICC_FILE_TYPE wordt gebruikt in de voorgaande MBIM_UICC_FILE_STATUS structuur.

Typ Waarde Beschrijving
MBIMUiccFileTypeUnknown 0 Bestandstype onbekend.
MBIMUiccFileTypeWorkingEf 1 Functionerende EF.
MBIMUiccFileTypeInternalEf 2 Interne EF.
MBIMUiccFileTypeDfOrAdf 3 Speciale map, een map die de bovenliggende directory van andere knooppunten is. Dit kan een DF of ADF zijn.

MBIM_UICC_FILE_STRUCTURE

De opsomming MBIM_UICC_FILE_STRUCTURE wordt gebruikt in de voorgaande MBIM_UICC_FILE_STATUS structuur.

Type Waarde Beschrijving
MBIMUiccFileStructureUnknown 0 Een onbekende bestandsstructuur.
MBIMUiccFileStructureTransparent 1 Eén record met variabele lengte.
MBIMUiccFileStructureCyclic 2 Een cyclische set records, elk van dezelfde lengte.
MBIMUiccFileStructureLinear 3 Een lineaire set records, elk van dezelfde lengte.
MBIMUiccFileStructureBerTLV 4 Een set gegevenswaarden die toegankelijk zijn per tag.

MBIM_PIN_TYPE_EX

De opsomming MBIM_PIN_TYPE_EX wordt gebruikt in de voorgaande MBIM_UICC_FILE_STATUS structuur.

Type Waarde Beschrijving
MBIMPinTypeNone 0 Er hoeft geen pincode te worden ingevoerd.
MBIMPinTypeCustom 1 Het type pincode is een aangepast type en is geen van de andere pincodetypen die in deze opsomming worden vermeld.
MBIMPinTypePin1 2 De pincode1.
MBIMPinTypePin2 3 PIN2-sleutel.
MBIMPinTypeDeviceSimPin 4 Het apparaat naar SIM-toets.
MBIMPinTypeDeviceFirstSimPin 5 Het apparaat naar de allereerste SIM-sleutel.
MBIMPinTypeNetworkPin 6 De persoonlijke netwerksleutel.
MBIMPinTypeNetworkSubsetPin 7 De persoonlijke instellingensleutel voor de netwerksubset.
MBIMPinTypeServiceProviderPin 8 De persoonlijke sleutel van de serviceprovider (SP).
MBIMPinTypeCorporatePin 9 De bedrijfsgepersonaliseerde sleutel.
MBIMPinTypeSubsidyLock 10 De subsidieontgrendelingssleutel.
MBIMPinTypePuk1 11 De ontgrendelingssleutel voor persoonlijke identificatienummer 1 (PUK1).
MBIMPinTypePuk2 12 De ontgrendelingssleutel voor het persoonlijke identificatienummer 2 (PUK2).
MBIMPinTypeDeviceFirstSimPuk 13 Het apparaat voor de allereerste SIM PIN ontgrendelsleutel.
MBIMPinTypeNetworkPuk 14 De ontgrendelingssleutel voor netwerk personalisatie.
MBIMPinTypeNetworkSubsetPuk 15 De ontgrendelingssleutel voor persoonlijke instellingen voor de netwerksubset.
MBIMPinTypeServiceProviderPuk 16 De ontgrendelingssleutel voor personalisatie van de serviceprovider (SP).
MBIMPinTypeCorporatePuk 17 De ontgrendelingssleutel voor bedrijfsaanpassingen.
MBIMPinTypeNev 18 De NEV-sleutel.
MBIMPinTypeAdm 19 De beheersleutel.

Ongevraagde gebeurtenissen

Niet van toepassing.

Status codes

De volgende statuscodes zijn van toepassing:

Statuscode Beschrijving
MBIM_STATUS_BUSY Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_MISLUKT Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_SIM_NIET_GEPLAATST Kan de UICC-bewerking niet uitvoeren omdat de UICC ontbreekt.
MBIM_STATUS_BAD_SIM - Slechte SIM-status Kan de UICC-bewerking niet uitvoeren omdat de UICC een foutstatus heeft.
MBIM_STATUS_DEELBAARHEID_VOORWAARDEN_FOUT Het bestand kan niet worden geselecteerd omdat het niet kan worden gedeeld en momenteel wordt geopend door een andere toepassing. Het statuswoord dat door de SIM wordt geretourneerd, is 6985.

MBIM_CID_MS_UICC_ACCESS_BINARY

Deze CID verzendt een specifieke opdracht voor toegang tot een binair UICC-bestand, met structuurtype MBIMUiccFileStructureTransparent of MBIMUiccFileStructureBerTLV.

Parameters

Operatie Set Zoekopdracht Melding
Bevelen Niet van toepassing MBIM_UICC_ACCESS_BINARY Niet van toepassing
Antwoord Niet van toepassing MBIM_UICC_RESPONSE Niet van toepassing

Vraag

Leest een binair bestand. De InformationBuffer voor MBIM_COMMAND_MSG bevat een MBIM_UICC_ACCESS_BINARY-structuur. Een MBIM_UICC_RESPONSE-structuur wordt geretourneerd in de InformationBuffer van MBIM_COMMAND_DONE.

MBIM_UICC_ACCESS_BINARY (versie 1)

Compensatie Grootte Veld Type Beschrijving
0 4 Versie UINT32 Het versienummer van de structuur die volgt. Dit veld moet worden ingesteld op 1 voor versie 1 van deze structuur.
4 4 AppIdOffset VERSCHUIVING De verschuiving, in bytes, vanaf het begin van deze structuur tot de buffer met de toepassings-ID.
8 4 AppIdSize GROOTTE (0..16) De grootte van de toepassings-id, in bytes, zoals gedefinieerd in sectie 8.3 van het ETSI TS 102 221 technische specificatie. Voor 2G-kaarten moet dit veld worden ingesteld op nul (0).
12 4 FilePathOffset VERSCHUIVING De offset, in bytes, berekend vanaf het begin van deze structuur tot aan de buffer die het bestandspad bevat. Het bestandspad is een matrix van 16-bits bestands-id's. De eerste id moet 0x7FFF of 0x3F00zijn. Als de eerste id 0x7FFFis, dan is het pad relatief aan de ADF van de door AppIdaangewezen toepassing. Anders is het een absoluut pad vanaf de MF.
16 4 FilePathSize GROOTTE De grootte van het bestandspad, in bytes.
20 4 FileOffset UINT32 De offset die moet worden gebruikt bij het lezen van het bestand. Dit veld kan groter zijn dan 256 en combineert zowel hoge offset als lage offset zoals gedefinieerd in de technische specificatie van ETSI TS 102 221.
24 4 NumberOfBytes UINT32 Het aantal te lezen bytes. Een clientstuurprogramma kan deze functie bijvoorbeeld gebruiken om een transparant (binair) bestand te lezen dat groter is dan 256 bytes, hoewel de maximale hoeveelheid die kan worden gelezen of geschreven in één UICC-bewerking 256 bytes is volgens de technische specificatie ETSI TS 102 221. Het is de verantwoordelijkheid van de functie om dit op te splitsen in meerdere APDUs en het resultaat in één antwoord terug te sturen.
28 4 LocalPinOffset VERPLAATSING De offset, in bytes, berekend vanaf het begin van deze structuur tot de buffer die het wachtwoord bevat. Dit is de lokale pincode (PIN2) en wordt gebruikt voor het geval voor de bewerking lokale pincodevalidatie is vereist.
32 4 LocalPinSize GROOTTE (0..16) De grootte van het wachtwoord, in bytes.
36 4 Offset van binaire gegevens VERSCHUIVING De offset, in bytes, berekend vanaf het begin van deze structuur tot aan de buffer met gegevens die specifiek voor de opdracht zijn. Binaire gegevens worden alleen gebruikt voor SET-bewerkingen.
40 4 BinaryDataSize GROOTTE (0..32768) De grootte van de gegevens, in bytes.
44 DataBuffer gegevensbuffer De gegevensbuffer met AppId, FilePath, LocalPin en BinaryData.

Set

Niet van toepassing.

Antwoord

De volgende MBIM_UICC_RESPONSE structuur wordt gebruikt in de InformationBuffer.

MBIM_UICC_RESPONSE (versie 1)

Afstand Grootte Veld Type Beschrijving
0 4 Versie UINT32 Het versienummer van de structuur die volgt. Dit veld moet 1 zijn voor versie 1 van deze structuur.
4 4 StatusWord1 UINT32(0..256) Een retourparameter die specifiek is voor de UICC-opdracht.
8 4 StatusWord2 UINT32(0..256) Een retourparameter die specifiek is voor de UICC-opdracht.
12 4 ResponsDataOffset VERSCHUIVING De verschuiving, in bytes, berekend vanaf het begin van deze structuur naar de buffer die de reactiegegevens bevat. De antwoordgegevens worden alleen gebruikt voor QUERY-bewerkingen.
16 4 Responsgegevensgrootte GROOTTE (0..32768) De grootte van de gegevens, in bytes.
20 Gegevensbuffer DATABUFFER De gegevensbuffer met ResponseData.

Ongevraagde gebeurtenissen

Niet van toepassing.

Statuscodes

De volgende statuscodes zijn van toepassing:

Statuscode Beschrijving
MBIM_STATUS_BUSY Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_FAILURE Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_SIM-kaart_niet_geplaatst Kan de UICC-bewerking niet uitvoeren omdat de UICC ontbreekt.
MBIM_STATUS_ONGELDIGE_SIM Kan de UICC-bewerking niet uitvoeren omdat de UICC een foutstatus heeft.
MBIM_STATUS_GEDEELDE_CONDITIE_FOUT Het bestand kan niet worden geselecteerd omdat het niet kan worden gedeeld en momenteel wordt geopend door een andere toepassing. Het statuswoord dat door de SIM wordt geretourneerd, is 6985.
MBIM_STATUS_PIN_FAILURE De bewerking is mislukt vanwege een pincodefout.

MBIM_CID_MS_UICC_ACCESS_RECORD

Deze CID verzendt een specifieke opdracht voor toegang tot een UICC lineair vast bestand of cyclisch bestand, met de structuurtype MBIMUiccFileStructureCyclic of MBIMUIccFileStructureLinear.

Parameters

Operatie Instellen Vraag Melding
Bevelen Niet van toepassing MBIM_UICC_ACCESS_RECORD Niet van toepassing
Antwoord Niet van toepassing MBIM_UICC_RESPONSE Niet van toepassing

Vraag

Leest de inhoud van een record. De InformationBuffer voor MBIM_COMMAND_MSG bevat de volgende MBIM_UICC_ACCESS_RECORD structuur. MBIM_UICC_RESPONSE wordt geretourneerd in de InformationBuffer van MBIM_COMMAND_DONE.

MBIM_UICC_ACCESS_RECORD (versie 1)

Afstand Grootte Veld Type Beschrijving
0 4 Versie UINT32 Het versienummer van de structuur die volgt. Dit veld moet worden ingesteld op 1 voor versie 1 van deze structuur.
4 4 AppIdOffset VERSCHUIVING De offset, in bytes, vanaf het begin van deze structuur tot de buffer met de toepassings-id.
8 4 App-ID Grootte GROOTTE (0..16) De grootte van de toepassings-id, in bytes, zoals gedefinieerd in sectie 8.3 van het ETSI TS 102 221 technische specificatie. Voor 2G-kaarten moet dit veld worden ingesteld op nul (0).
12 4 FilePathOffset VERSCHUIVING De offset, in bytes, berekend vanaf het begin van deze structuur naar de buffer die het bestandspad bevat. Het bestandspad is een matrix van 16-bits bestands-id's. De eerste id moet 0x7FFF of 0x3F00zijn. Als de eerste ID 0x7FFFis, is het pad relatief ten opzichte van de ADF van de toepassing die wordt aangeduid door AppId. Anders is het een absoluut pad dat begint bij de MF.
16 4 FilePathSize GROOTTE De grootte van het bestandspad, in bytes.
20 4 RecordNummer UINT32(0..256) Het recordnummer. Dit vertegenwoordigt altijd de absolute recordindex. Relatieve recordtoegang wordt niet ondersteund omdat de modem meerdere toegangsrechten op een bestand kan uitvoeren (VOLGENDE, VORIGE).
24 4 LocalPinOffset VERSCHUIVING De offset, in bytes, berekend vanaf het begin van deze structuur tot de buffer die het wachtwoord bevat. Het vergrendelingswachtwoord is een door null beëindigde UTF-8-tekenreeks met decimale cijfers.
28 4 LocalPinSize GROOTTE (0..16) De grootte van het wachtwoord, in bytes.
32 4 RecordDataOffset COMPENSATIE De offset, in bytes, berekend vanaf het begin van deze structuur tot aan de buffer met de opdrachtspecifieke gegevens. Recordgegevens worden alleen gebruikt voor SET-bewerkingen.
36 4 RecordDataSize GROOTTE (0..256) De grootte van de gegevens, in bytes.
40 Databuffer DATABUFFER De gegevensbuffer met AppId, FilePath, LocalPin en RecordData.

Stel

Niet van toepassing.

Antwoord

In de InformationBuffer wordt een MBIM_UICC_RESPONSE structuur gebruikt.

Ongevraagde gebeurtenissen

Niet van toepassing.

Statuscodes

De volgende statuscodes zijn van toepassing:

Statuscode Beschrijving
MBIM_STATUS_BUSY Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_FAILURE Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_SIM_NIET_INGEVOERD Kan de UICC-bewerking niet uitvoeren omdat de UICC ontbreekt.
MBIM_STATUS_SLECHTE_SIM Kan de UICC-bewerking niet uitvoeren omdat de UICC een foutstatus heeft.
MBIM_STATUS_SHAREABILITY_CONDITION_ERROR Het bestand kan niet worden geselecteerd omdat het niet kan worden gedeeld en momenteel wordt geopend door een andere toepassing. Het statuswoord dat door de SIM wordt geretourneerd, is 6985.
MBIM_STATUS_PIN_FAILURE De bewerking is mislukt vanwege een pincodefout.

MBIM_CID_MS_PIN_EX

Deze CID wordt gebruikt om alle beveiligingsbewerkingen voor pincodes uit te voeren, zoals gedefinieerd in sectie 9 van de technische specificatie ETSI TS 102 221. De CID is vergelijkbaar met MBIM_CID_MS_PIN, maar breidt deze uit om UICC-kaarten met meerdere apps te ondersteunen. Alleen UICC's die geschikt zijn voor één verificatie worden ondersteund. Voor meervoudige verificatie geschikte UICC's die meer dan één toepassingspincode ondersteunen, worden niet ondersteund. Eén toepassingspincode (PIN1) wordt toegewezen aan alle ADFs/DFS en bestanden in de UICC. Elke toepassing kan echter een lokale pincode (PIN2) opgeven als verificatievereiste voor gebruikers op niveau 2, wat resulteert in de noodzaak van extra validatie voor elke toegangsopdracht. Dit scenario is wat MBIM_CID_MS_PIN_EX ondersteunt.

Net als bij MBIM_CID_MS_PIN, meldt het apparaat met MBIM_CID_MS_PIN_EX slechts één pincode tegelijk. Als meerdere pincodes zijn ingeschakeld en er meerdere pincodes worden gerapporteerd, moeten functies eerst pincode1 rapporteren. Als bijvoorbeeld subsidievergrendelingsrapportage is ingeschakeld en de PINCODE1 van de SIM is ingeschakeld, moet de pincode voor subsidievergrendeling alleen worden gerapporteerd in een volgende queryaanvraag nadat PIN1 is geverifieerd. Een lege pincode is toegestaan samen met MBIMPinOperationEnter. Er wordt een lege pincode opgegeven door pinSize in te stellen op nul. In dit geval is een SET-opdracht vergelijkbaar met een QUERY en wordt de status van de pincode geretourneerd waarnaar wordt verwezen. Dit is volledig afgestemd op het gedrag van de opdracht VERIFY, zoals opgegeven in sectie 11.1.9 van de technische specificatie van de ETSI TS 102 221.

Parameters

Operatie Instellen Vraag Melding
Bevelen MBIM_SET_PIN_EX MBIM_PIN_APP Niet van toepassing
Antwoord MBIM_PIN_INFO_EX MBIM_PIN_INFO_EX Niet van toepassing

Vraag

De volgende MBIM_PIN_APP structuur wordt gebruikt in de InformationBuffer.

MBIM_PIN_APP (versie 1)

Afstand Grootte Veld Soort Beschrijving
0 4 Versie UINT32 Het versienummer van de structuur die volgt. Dit veld moet worden ingesteld op 1 voor versie 1 van deze structuur.
4 4 AppIdOffset VERSCHUIVING De offset, in bytes, vanaf het begin van deze structuur tot de buffer met de applicatie-ID.
8 4 AppIdSize GROOTTE (0..16) De grootte van de toepassings-id, in bytes, zoals gedefinieerd in sectie 8.3 van het ETSI TS 102 221 technische specificatie. Voor 2G-kaarten moet dit veld worden ingesteld op nul (0).
12 Gegevensbuffer gegevensbuffer De AppId zoals gedefinieerd in de technische specificatie ETSI TS 102 221.

Set

De volgende MBIM_SET_PIN_EX structuur wordt gebruikt in de InformationBuffer.

MBIM_SET_PIN_EX

Offset Grootte Veld Type Beschrijving
0 4 PinType MBIM_PIN_TYPE_EX Het pincodetype. Zie de MBIM_PIN_TYPE_EX tabel in dit onderwerp.
4 4 PinOperation MBIM_PIN_OPERATIE De pincodebewerking. Zie MBIM 1.0.
8 4 Pinuitwijking COMPENSATIE De offset, in bytes, berekend vanaf het begin van deze structuur naar een tekenreeks-PIN die de PIN-waarde vertegenwoordigt waarmee de actie moet worden uitgevoerd, of de PIN-waarde die nodig is om PIN-instellingen in te schakelen of uit te schakelen. Dit veld is van toepassing op alle waarden van PinOperation.
12 4 Pin-grootte GROOTTE (0..32) De grootte, in bytes, die wordt gebruikt voor de pincode.
16 4 NewPinOffset VERPLAATSING De verplaatsing, in bytes, berekend vanaf het begin van deze structuur tot de tekenreeks NewPin die de nieuwe pincodewaarde vertegenwoordigt die moet worden ingesteld wanneer PinOperation MBIMPinOperationChange of MBIMPinOperationEnter is, voor PinTypeMBIMPinTypePuk1 of PinTypeMBIMPinTypePuk2.
20 4 NewPinSize GROOTTE (0..32) De grootte, in bytes, die wordt gebruikt voor de NewPin.
24 4 AppIdOffset VERGRENDELING De offset, in bytes, berekend vanaf het begin van deze structuur naar de buffer die de toepassings-id bevat.
28 4 AppIdSize GROOTTE (0..16) De grootte van de toepassings-id, in bytes, zoals gedefinieerd in sectie 8.3 van het ETSI TS 102 221 technische specificatie. Voor 2G-kaarten moet dit veld worden ingesteld op nul (0).
32 Gegevensbuffer databuffer De gegevensbuffer die de Pin, NewPin en AppId bevat.

Antwoord

De volgende MBIM_PIN_INFO_EX structuur wordt gebruikt in de InformationBuffer.

Afstand Grootte Veld Soort Beschrijving
0 4 PinType MBIM_PIN_TYPE_EX Het pincodetype. Zie de MBIM_PIN_TYPE_EX tabel in dit onderwerp.
4 4 PinState MBIM_PIN_STATUS De status van de PIN-code. Zie MBIM 1.0.
8 4 Resterende pogingen UINT32 Het aantal resterende pogingen voor bewerkingen met betrekking tot pincodes, zoals invoeren, inschakelen of uitschakelen. Apparaten die deze informatie niet ondersteunen, moeten dit lid instellen op 0xFFFFFFFF.

Ongevraagde gebeurtenissen

Niet van toepassing.

Statuscodes

De volgende statuscodes zijn van toepassing:

Statuscode Beschrijving
MBIM_STATUS_BUSY Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_FAILURE Standaard MBIM-status zoals gedefinieerd voor alle opdrachten.
MBIM_STATUS_SIM_NOT_INSERTED (SIM-kaart niet geplaatst) Kan de UICC-bewerking niet uitvoeren omdat de UICC ontbreekt.
MBIM_STATUS_SLECHTE_SIM Kan de UICC-bewerking niet uitvoeren omdat de UICC een foutstatus heeft.
MBIM_STATUS_PIN_Uitschakelen De bewerking is mislukt omdat de pincode is uitgeschakeld.
MBIM_STATUS_PIN_REQUIRED De bewerking is mislukt omdat er een pincode moet worden ingevoerd om door te gaan.
MBIM_STATUS_GEEN_ONDERSTEUNING_VOOR_APPARAAT De bewerking is mislukt omdat een SET op een bijbehorend pincodetype niet wordt ondersteund door het apparaat.