您好,欢迎访问三七文档
WINHTTP.WINHTTPREQUEST.5.1WinHttp的属性属性访问类型说明Option读/写设置或检索WinHTTP选项值。ResponseBody只读作为一个无符号字节数组中检索响应实体正文。ResponseStream只读检索响应实体正文作为IStream。ResponseText只读检索响应实体正文作为string。Status只读从上一次响应检索的HTTP状态代码。StatusText只读检索HTTP状态文本。WinHttp的事件OnError:当应用程序运行错误时发生。OnResponseDataAvailable:当响应可用数据时发生。OnResponseFinished:响应数据完成时发生。OnResponseStart:当响应数据开始接收时发生。备注:(原文)TheWinHttpRequestobjectusestheIErrorInfointerfacetoprovideerrordata.该WinHttpRequest对象使用IErrorInfo接口来提供错误数据。AdescriptionandnumericalerrorvaluecanbeobtainedwiththeErrobjectinMicrosoftVisualBasicScriptingEdition(VBScript),andtheErrorobjectinMicrosoftJScript.Thelower16bitsofanerrornumbercorrespondtothevaluesfoundinErrorMessages.NoteForWindowsXPandWindows2000,seeRun-TimeRequirements.注意:对于WindowsXP和Windows2000,请参阅运行时间要求。WinHttp的方法Abort:中止一个WinHTTP的发送方法。GetAllResponseHeaders:检索所有HTTP响应标头。GetResponseHeader:检索HTTP响应标头。Open:打开一个HTTP连接到HTTP资源。Send:向HTTP服务器发送一个HTTP请求。SetAutoLogonPolicy:设置当前的自动登录策略。SetClientCertificate:选择要发送到安全超文本传输协议(HTTPS)服务器的客户端证书。SetCredentials:设置要使用的凭据与HTTP服务器,要么是原籍国或代理服务器。SetProxy:设置代理服务器信息。SetRequestHeader:添加、更改或删除HTTP请求标头。SetTimeouts:以毫秒为单位,指定一个发送/接收操作的单个超时组件。WaitForResponse:指定的等待时间,以秒为单位,为一种异步发送方法完成,使用可选的超时值。GetAllResponseHeaders方法bstrHeader(必需):指定不区分大小写的标头名称的string类型的值。ReturnValue:此方法返回在bstrHeader中命名的HTTP响应标头的值。Open方法bstrMethod(必需):一个值类型的字符串,它指定用于Open方法,如获取或放的HTTP谓词。总是使用大写,如某些服务器忽略小写的HTTP谓词。•bstrUrl(必需):一个值类型的字符串,其中包含的资源的名称。这必须是一个绝对URL。•varAsync(默认=false):类型值的布尔值,指定是否在异步模式下打开。True=在异步模式下打开的HTTP连接。Send方法varBody(可选):要发送到服务器的数据。要发送的请求是在之前调用Open方法中定义的。调用应用程序可以提供通过varBody参数到服务器发送的数据。如果该对象的Open的HTTP方式是GET,此方法发送的请求没有varBody,即使它由调用应用程序提供。如果是POST方式,则要跟上需要包体(a=1&b=2&c=3)做参数,书写格式request.send(data),VB不加括号提示参数不正确SetTimeouts方法ResolveTimeout:整数整数类型的值。应用时(如)的主机名称解析为IP地址(如192.168.131.199),以毫秒为单位的超时值。默认值为零,也就是说,没有超时(无限)。如果使用NAME_RESOLUTION_TIMEOUT指定的DNS超时时间,则还有一个请求一个线程开销。ConnectTimeout:整数整数类型的值。应用建立的通讯插座与目标服务器,以毫秒为单位时的超时值。默认值是60000(60秒)。SendTimeout:整数整数类型的值。应用时将请求数据的单个数据包通信套接字上发送到目标服务器,以毫秒为单位的超时值。大的请求发送到HTTP服务器通常被划分成多个数据包;发送超时适用于单独发送每个数据包。默认值为30000(30秒)。ReceiveTimeout:整数整数类型的值。应用时接收的响应数据的数据包,在目标服务器上,以毫秒为单位的超时值。大的反应,这是断成多个数据包;向上接收超时值适用于每个数据包的数据从套接字读取。默认值为30000(30秒)。所有参数都是必需的。值为0或-1设置了一个超时等待无限。大于0的值设置超时值以毫秒为单位。例如,30,000将设置的超时值为30秒。除-1以外的所有负值会都导致此方法失败。WaitForResponse方法Timeout(可选):以秒为单位的超时值。默认超时时间是无限的。对无限的显式设置超时,使用值-1。ReturnValue返回值:true=A尚未收到答复。false=A超时错误发生。WaitForResponse方法将等待异步发送方法完成,使用可选的超时值,以秒为单位。此方法会挂起执行等待异步请求的响应。在发送后,应调用此方法。调用应用程序可以指定一个可选的超时值,以秒为单位。如果此方法超时,该请求不会中止。这种方式调用的应用程序可以继续等待请求,如果需要,在对此方法的后续调用。后同步的Send方法立即返回,不起作用,请调用此属性。使用方法:1.创建对象(CreateObject)2.以需要的方式(POST/GET)打开(.open)3.设置请求头部(.setRequestHeaders)4.发送(.send)5.等待响应得到响应结果(例.responseText)。//-------------------------------------------------------------------------------------------------------以上为我自己整理大部分为机翻,水平有限,希望更懂的朋友来完善。参考原文:WINHTTP.WINHTTPREQUEST.5.1LastUpdatedApril2008IgottiredofwaitingforMSDNasareferencetousingtheWinHttpActiveXObject,soI'mtranscribingthingshere.VisitMSDN'sWinHttpRequestObjectReferencefortheoriginalcontent.MethodsofWinHttp•Abort:AbortsaWinHTTPSendmethod.•GetAllResponseHeaders:RetrievesallHTTPresponseheaders.•GetResponseHeader:RetrievestheHTTPresponseheaders.•Open:OpensanHTTPconnectiontoanHTTPresource.•Send:SendsanHTTPrequesttoanHTTPserver.•SetAutoLogonPolicy:SetsthecurrentAutomaticLogonPolicy.•SetClientCertificate:SelectsaclientcertificatetosendtoaSecureHypertextTransferProtocol(HTTPS)server.•SetCredentials:SetscredentialstobeusedwithanHTTPserver—eitheranoriginoraproxyserver.•SetProxy:Setsproxyserverinformation.•SetRequestHeader:Adds,changes,ordeletesanHTTPrequestheader.•SetTimeouts:Specifies,inmilliseconds,theindividualtime-outcomponentsofasend/receiveoperation.•WaitForResponse:Specifiesthewaittime,inseconds,foranasynchronousSendmethodtocomplete,withoptionaltime-outvalue.PropertiesofWinHttp•Option:SetsorretrievesaWinHTTPoptionvalue.•ResponseBody:Retrievestheresponseentitybodyasanarrayofunsignedbytes.•ResponseStream:RetrievestheresponseentitybodyasanIStream.•ResponseText:Retrievestheresponseentitybodyasastring.•Status:RetrievestheHTTPstatuscodefromthelastresponse.•StatusText:RetrievesHTTPstatustext.EventsofWinHttp•OnError:Occurswhenthereisarun-timeerrorintheapplication.•OnResponseDataAvailable:Occurswhendataisavailablefromtheresponse.•OnResponseFinished:Occurswhentheresponsedataiscomplete.•OnResponseStart:Occurswhentheresponsedatastartstobereceived.GETRESPONSEHEADERMETHOD•bstrHeader(required):Avalueoftypestringthatspecifiesthecase-insensitiveheadername.•ReturnValue:ThismethodreturnsthevalueoftheHTTPresponseheadernamedinbstrHeader.InvokethismethodonlyaftertheSendmethodhasbeencalled.//InstantiateaWinHttpRequestobject.varWinHttpReq=newActiveXObject(WinHttp.WinHttpRequest.5.1);//InitializeanHTTPrequest.WinHttpReq.Open(GET,);//SendtheHTTPrequest.WinHttpReq.Send();//Displaythedateheader.WScript.Echo(WinHttpReq.GetResponseHeader(Date));OPENMETHOD•bstrMethod(required):AvalueoftypestringthatspecifiestheHTTPverbusedfortheOpenme
本文标题:WINHTTP
链接地址:https://www.777doc.com/doc-2867353 .html