WinSock 2 API.pdf

Windows*Sockets2ApplicationProgrammingInterfaceAnInterfaceforTransparentNetworkProgrammingUnderMicrosoftWindowsTMRevision2.2.2August7,1997SubjecttoChangeWithoutNoticeiiDisclaimerandLicenseTHISSPECIFICATIONISPROVIDEDASISWITHNOWARRANTIESWHATSOEVER,INCLUDINGANYWARRANTYOFMERCHANTABILITY,FITNESSFORANYPARTICULARPURPOSE,ORANYWARRANTYOTHERWISEARISINGOUTOFANYPROPOSAL,SPECIFICATIONORSAMPLE.ALICENSEISHEREBYGRANTEDTOREPRODUCETHISSPECIFICATION,BUTONLYINITSENTIRETYANDWITHOUTMODIFICATION.NOOTHERLICENSE,EXPRESSORIMPLIED,BYESTOPPELOROTHERWISE,TOANYOTHERINTELLECTUALPROPERTYRIGHTSISGRANTEDHEREIN.INTEL,MICROSOFT,STARDUST,ANDTHEOTHERCOMPANIESWHOSECONTRIBUTIONSAREACKNOWLEDGEDBELOWDISCLAIMALLLIABILITY,INCLUDINGLIABILITYFORINFRINGEMENTOFANYPROPRIETARYRIGHTS,RELATINGTOIMPLEMENTATIONOFINFORMATIONINTHISSPECIFICATION.SAIDCOMPANIESDONOTWARRANTORREPRESENTTHATSUCHIMPLEMENTATION(S)WILLNOTINFRINGESUCHRIGHTS.*Third-partytrademarksarethepropertyoftheirrespectiveowners.iiiTableofContents1.INTRODUCTION....................................................................................................................................11.1.IntendedAudience...................................................................................................................................21.2.DocumentOrganization...........................................................................................................................21.3.StatusofThisSpecification.....................................................................................................................21.4.DocumentVersionConventions..............................................................................................................31.5.NewAnd/OrDifferentinVersion2.2.1...................................................................................................31.6.NewAnd/OrDifferentinVersion2.2.2...................................................................................................32.SUMMARYOFNEWCONCEPTS,ADDITIONSANDCHANGESFORWINSOCK2................42.1.WinSock2Architecture...........................................................................................................................42.1.1.SimultaneousAccesstoMultipleTransportProtocols.....................................................................42.1.2.BackwardsCompatibilityForWinSock1.1Applications................................................................42.1.2.1.SourceCodeCompatibility.........................................................................................................................42.1.2.2.BinaryCompatibility...................................................................................................................................52.2.MakingTransportProtocolsAvailableToWinSock...............................................................................52.2.1.LayeredProtocolsandProtocolChains............................................................................................62.2.2.UsingMultipleProtocols..................................................................................................................62.2.3.MultipleProviderRestrictionsonselect()........................................................................................72.3.FunctionExtensionMechanism...............................................................................................................72.4.DebugandTraceFacilities......................................................................................................................82.5.ProtocolIndependentNameResolution..................................................................................................82.6.OverlappedI/OandEventObjects..........................................................................................................82.6.1.EventObjects....................................................................................................................................92.6.2.ReceivingCompletionIndications..................................................................................................102.6.2.1.BlockingandWaitingforCompletionIndication.....................................................................................102.6.2.2.PollingforCompletionIndication............................................................................................................102.6.2.3.UsingsocketI/Ocompletionroutines.......................................................................................................102.6.2.4.Summaryofoverlappedcompletionindicationmechanisms....................................................................102.6.3.WSAOVERLAPPEDDetails.........................................................................................................112.7.AsynchronousNotificationUsingEventObjects..................................................................................112.8.QualityofService...................................