微软无线宽带接口开发指南.docx

微软无线宽带接口开发指南.docx

《微软无线宽带接口开发指南.docx》由会员分享，可在线阅读，更多相关《微软无线宽带接口开发指南.docx（25页珍藏版）》请在冰点文库上搜索。

微软无线宽带接口开发指南

MobileBroadbandConnectionManagerDevelopmentGuide

May28,2009

Abstract

Thispaperdescribeshowtowriteaconnectionmanager（CM）utilitythatmanagesmobilebroadbandconnectionsinWindows®7.Itprovidesguidelinesfororiginalequipmentmanufacturers（OEMs）,independentsoftwarevendors（ISVs）,andmobilenetworkoperators（MNOs）todeveloptheirownCMbyusingthemobilebroadbandAPIinWindows 7.Throughthesethird-partyCMs,vendorscaneitheraugmentorcompletelyreplacethenativeWindows 7ConnectionManager.

Thispaperisintendedtobeusedasbothatutorialandareferenceguideforcreatingthird-partymobilebroadbandCMsforWindows7.ItdescribesthedevelopmentstagesandtestingmethodologiesthatdevelopersshouldfollowtocreateaCM.

ThisinformationappliestotheWindows 7operatingsystem.

Referencesandresourcesdiscussedherearelistedattheendofthispaper.

ThecurrentversionofthispaperismaintainedontheWebat:

Disclaimer:

Thisisapreliminarydocumentandmaybechangedsubstantiallypriortofinalcommercialreleaseofthesoftwaredescribedherein.

TheinformationcontainedinthisdocumentrepresentsthecurrentviewofMicrosoftCorporationontheissuesdiscussedasofthedateofpublication.BecauseMicrosoftmustrespondtochangingmarketconditions,itshouldnotbeinterpretedtobeacommitmentonthepartofMicrosoft,andMicrosoftcannotguaranteetheaccuracyofanyinformationpresentedafterthedateofpublication.

ThisWhitePaperisforinformationalpurposesonly.MICROSOFTMAKESNOWARRANTIES,EXPRESS,IMPLIEDORSTATUTORY,ASTOTHEINFORMATIONINTHISDOCUMENT.

Complyingwithallapplicablecopyrightlawsistheresponsibilityoftheuser.Withoutlimitingtherightsundercopyright,nopartofthisdocumentmaybereproduced,storedinorintroducedintoaretrievalsystem,ortransmittedinanyformorbyanymeans（electronic,mechanical,photocopying,recording,orotherwise）,orforanypurpose,withouttheexpresswrittenpermissionofMicrosoftCorporation.

Microsoftmayhavepatents,patentapplications,trademarks,copyrights,orotherintellectualpropertyrightscoveringsubjectmatterinthisdocument.ExceptasexpresslyprovidedinanywrittenlicenseagreementfromMicrosoft,thefurnishingofthisdocumentdoesnotgiveyouanylicensetothesepatents,trademarks,copyrights,orotherintellectualproperty.

Unlessotherwisenoted,theexamplecompanies,organizations,products,domainnames,e-mailaddresses,logos,people,placesandeventsdepictedhereinarefictitious,andnoassociationwithanyrealcompany,organization,product,domainname,emailaddress,logo,person,placeoreventisintendedorshouldbeinferred.

©2009MicrosoftCorporation.Allrightsreserved.

MicrosoftandWindowsareeitherregisteredtrademarksortrademarksofMicrosoftCorporationintheUnitedStatesand/orothercountries.

Thenamesofactualcompaniesandproductsmentionedhereinmaybethetrademarksoftheirrespectiveowners.

DocumentHistory

Date

Change

May28,2009

Firstpublication

Contents

Introduction4

Overview4

ConnectionManagerDevelopmentStages5

Stage1:

BasicConnectivityFunctionality6

Stage1Testing8

Stage1AdditionalTasks8

Stage2:

HandlingChangestoRadioStateandSignalState8

Stage2Testing9

Stage2AdditionalTasks10

Stage3:

SecurityOperationsThatAreRelatedtoPINandPUK10

Stage3Testing11

Stage4:

SMSFunctionality11

ReadingSMSMessagesfromaDevice11

SendingSMSMessages12

ReadingSMSMessagesWhenTheyArrive12

Stage4Testing13

Stage5:

APNDatabaseIntegration13

OverviewofAPNDatabases13

UpdatingtheDevice’sFirmwarewithProvisionedContexts14

CreatingConnectionProfilesfromaProvisionedContext14

Stage5Testing15

Stage6:

ServiceActivationandVendor-SpecificOperations15

ServiceActivation15

Vendor-SpecificOperations17

Stage6Testing18

Resources19

Introduction

Thisdocumentdescribesthemethodsthatdeveloperscanusetocreateeitheralightweightorcompleteconnectionmanager（CM）.Thetargetaudienceforthisdocumentis:

∙Originalequipmentmanufacturers（OEMs）.

∙Independentsoftwarevendors（ISVs）.

∙Mobilenetworkoperators（MNOs）.

Thisdocumentprovidesguidelinesandtestingrecommendationsforthedevelopmentprocess.

Overview

InWindows7,OEMs,ISVs,orMNOscanprovidethefollowingmethodsforuserstomanagemobilebroadbandconnections:

∙UsethenativeWindows 7ConnectionManager.

UserscanstartthisutilitybyclickingtheNetworkiconinthenotificationarea.ThisNetworkiconflyoutisalsoknownastheViewAvailableNetworksuserinterface（VANUI）

TheVANUIprovidesaunifiedconnectionexperienceacrossmultiplemediatypes,suchasmobilebroadbandandwirelesslocalareanetworks（LANs）.Formobilebroadbandconnections,theVANUIimplementsthemostcommonlyusedfunctionality,whichincludesthefollowing:

∙Creationandconfigurationofconnectionsprofiles.Theseprofilescontainthesettingsfortheaccesspointname（APN）andcredentials（usernameandpassword）fortheuser’ssubscription.

∙Theabilitytoconnecttoordisconnectfromamediaconnectionoveranetworkinterface.

∙Configurationofthenetworkdevicetoauto-connectunderdifferentconditions.

∙Securityoperationsthatarerelatedtothedevice’spersonalidentificationnumber（PIN）andPINunblockingkey（PUK）.

∙Configurationofthedevice’sroamingparameters.

∙Theabilitytodiagnoseerrorsthatarerelatedtoconnectionfailures,networkerrors,andserviceerrors.

∙UsealightweightCMthatanOEM,ISV,orMNOprovides.

AlightweightCMaugmentsthenativeWindows7ConnectionManagerandprovidesadditionalfeaturesthatarenotavailableintheVANUI.

DeveloperscancreatealightweightCMbyusingthemobilebroadbandAPI.ThisAPIhasmethodsthatthird-partyCMscanusetocommunicatewithmobilebroadbanddevicesbyusingthemobilebroadbandstackinWindows7.

AlightweightCMthatisbuiltbyusingthisAPIcanworkwiththeVANUIandprovideadvancedfeaturesthatarenotsupportedintheVANUI.Thesefeaturesincludethefollowing:

∙Serviceactivation.

∙Connectionprovisioning.

∙SupportforenhancedsecurityoperationsbeyondPIN1andPUKsupport.

∙SupportfortheShortMessageService（SMS）.

∙APNdatabaseintegration.

∙UsethecompleteCMthatanOEM,ISV,orMNOprovides.

ThistypeofCMduplicatesallthefeaturesofVANUIandalsosupportsadditionalfeaturesasrequired.

AdevelopercreatesacompleteCMbyusingthemobilebroadbandAPI.

AlightweightorcompleteCMcanreliablymanagemobilebroadbanddevicesthathaveadriverthathasbeencertifiedbytheWindowsLogoProgram（WLP）forWindows7.Conversely,anOEM,ISV,orMNOcanuseanymobilebroadbanddevicewithalogo-certifieddriverwhenitteststheimplementationofitsCM.

ConnectionManagerDevelopmentStages

ThissectiondescribesthefollowingstepsthatyoumustusetodevelopaCMbyusingthemobilebroadbandAPIinWindows 7:

Stage1:

BasicConnectivityFunctionality

Thisstepimplementsthebasicabilitytoconnectthroughamobilebroadbandinterface.

Formoreinformation,referto“Stage1:

BasicConnectivityFunctionality”laterinthispaper.

Stage2:

HandlingChangestoRadioStateandSignalState

Thisstepimplementstheabilitytodetectandhandlechangestothemobilebroadbanddevice’sradioandsignalstate.

Formoreinformation,referto“Stage2:

HandlingChangestoRadioStateandSignalState”laterinthispaper.

Stage3:

SecurityOperationsthatAreRelatedtoPINandPUK

Thisstepimplementsthesupportofoperationsthatarerelatedtothedevice’sPINandPUK.

Formoreinformation,referto“Stage3:

SecurityOperationsthatAreRelatedtoPINandPUK”laterinthispaper.

Stage4:

SMSFunctionality

ThisstepimplementsthesupportofSMSoperations,includingreadingandwritingSMSmessages.

Formoreinformation,referto“Stage4:

SMSFunctionality”laterinthispaper.

Note  IfyouaredevelopingalightweightCM,youcanbegindevelopmentatthisstage.

Stage5:

APNDatabaseIntegration

Thisstepimplementsthesupportforintegratingthedevice’sAPNdatabasewiththeCM.

Formoreinformation,referto“Stage5:

APNDatabaseIntegration”laterinthispaper.

Stage6:

ServiceActivationandVendor-SpecificOperations

Thisstepimplementsthesupportofserviceactivationandvendor-specificoperations.

Formoreinformation,referto“Stage6:

ServiceActivationandVendor-SpecificOperations”laterinthispaper.

ForacompletedescriptionofthemobilebroadbandAPI,referto“MobileBroadbandAPIReference”intheWindowsDriverKit（WDK）.

Stage1:

BasicConnectivityFunctionality

Stage1involvesimplementingbasicconnectivityfunctionality.Tosupportbasicconnectivity,theCMmustusethefollowingmobilebroadbandAPIinterfaces:

Interface

Description

IMbnConnection

ProvidesConnectandDisconnectmethods.

IMbnConnectionContext

Providesmethodstogetandsetpreprovisionedcontextsonthedevice.

IMbnConnectionEvents

Providesnotificationsonconnectionanddisconnectioncompletion.

IMbnConnectionManager

Maintainsalistofavailableconnections.

IMbnConnectionManagerEvents

Providesnotificationsthatarerelatedtoconnectionarrivalandremoval.

IMbnConnectionProfile

Providesprofilequeryandupdatemethods.

IMbnConnectionProfileManager

Maintainsalistofprofilesforagiveninterfaceandprovidesprofilecreationmethods.

IMbnConnectionProfileManagerEvents

Providesconnectionprofilearrivalandremovalnotifications.

IMbnInterface

Providesmethodstogetinterfa