微软无线宽带接口开发指南.docx
- 文档编号:9650281
- 上传时间:2023-05-20
- 格式:DOCX
- 页数:25
- 大小:67.59KB
微软无线宽带接口开发指南.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
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 微软 无线 宽带 接口 开发 指南