IWinHttpRequest::Send 方法
Send 方法将 HTTP 请求发送到 HTTP 服务器。
语法
HRESULT Send(
[in, optional] VARIANT Body
);
参数
-
正文 [in, 可选]
-
要发送到服务器的数据。
返回值
返回值在成功 时S_OK ,否则返回值为错误值。
备注
要发送的请求是在对 Open 方法的先前调用中定义的。 调用应用程序可以提供要通过 Body 参数发送到服务器的数据。 如果对象的 Open 的 HTTP 谓词为“GET”,则此方法发送的请求不带 Body,即使它是由调用应用程序提供的。
注意
对于 Windows XP 和 Windows 2000,请参阅 WinHttp 起始页的 运行时要求 部分。
示例
以下示例演示如何打开 HTTP 连接、发送 HTTP 请求和读取响应文本。
#include <windows.h>
#include <stdio.h>
#include <objbase.h>
#include "httprequest.h"
#pragma comment(lib, "ole32.lib")
#pragma comment(lib, "oleaut32.lib")
// IID for IWinHttpRequest.
const IID IID_IWinHttpRequest =
{
0x06f29373,
0x5c5a,
0x4b54,
{0xb0, 0x25, 0x6e, 0xf1, 0xbf, 0x8a, 0xbf, 0x0e}
};
int main()
{
// variable for return value
HRESULT hr;
// initialize COM
hr = CoInitialize( NULL );
IWinHttpRequest * pIWinHttpRequest = NULL;
BSTR bstrResponse = NULL;
VARIANT varFalse;
VARIANT varEmpty;
CLSID clsid;
VariantInit(&varFalse);
V_VT(&varFalse) = VT_BOOL;
V_BOOL(&varFalse) = VARIANT_FALSE;
VariantInit(&varEmpty);
V_VT(&varEmpty) = VT_ERROR;
hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);
if (SUCCEEDED(hr))
{
hr = CoCreateInstance(clsid, NULL,
CLSCTX_INPROC_SERVER,
IID_IWinHttpRequest,
(void **)&pIWinHttpRequest);
}
if (SUCCEEDED(hr))
{ // Open WinHttpRequest.
BSTR bstrMethod = SysAllocString(L"GET");
BSTR bstrUrl = SysAllocString(L"https://microsoft.com");
hr = pIWinHttpRequest->Open(bstrMethod, bstrUrl, varFalse);
SysFreeString(bstrMethod);
SysFreeString(bstrUrl);
}
if (SUCCEEDED(hr))
{ // Send Request.
hr = pIWinHttpRequest->Send(varEmpty);
}
if (SUCCEEDED(hr))
{ // Get Response text.
hr = pIWinHttpRequest->get_ResponseText(&bstrResponse);
}
// Print response to console.
wprintf(L"%.256s",bstrResponse);
// Release memory.
if (pIWinHttpRequest)
pIWinHttpRequest->Release();
if (bstrResponse)
SysFreeString(bstrResponse);
CoUninitialize();
return 0;
}
以下脚本示例演示如何打开 HTTP 连接、发送 HTTP 请求和读取响应文本。
// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
// Initialize an HTTP request.
WinHttpReq.Open("GET", "https://www.microsoft.com", false);
// Send the HTTP request.
WinHttpReq.Send();
// Display the response text.
WScript.Echo( WinHttpReq.ResponseText);
以下脚本示例演示如何将数据发布到 HTTP 服务器。
// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
// Initialize an HTTP request.
WinHttpReq.Open("PUT", "https://postserver/newdoc.htm", false);
// Post data to the HTTP server.
WinHttpReq.Send("Post data");
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP、Windows 2000 Professional SP3 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003、Windows 2000 Server SP3 [仅限桌面应用] |
可再发行组件 |
Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更高版本。 |
IDL |
|
库 |
|
DLL |
|