Свойство IWinHttpRequest::ResponseText
Свойство ResponseText извлекает текст сущности ответа в виде текста.
Это свойство доступно только для чтения.
Синтаксис
HRESULT get_ResponseText(
[out, retval] BSTR *Body
);
strResponseText = WinHttpRequest.ResponseText
Значение свойства
BSTR , получающий текст сущности ответа в виде текста.
Коды ошибок
Возвращаемое значение S_OK при успешном выполнении или значение ошибки в противном случае.
Комментарии
Это свойство можно вызвать только после вызова метода Send .
При использовании этого свойства в синхронном режиме ограничение на количество возвращаемых символов составляет приблизительно 2 169 895 символов.
Примечание
Для 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 the response to a 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);
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения] |
Минимальная версия сервера |
Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения] |
Распространяемые компоненты |
WinHTTP 5.0 и Internet Обозреватель 5.01 или более поздней версии в Windows XP и Windows 2000. |
IDL |
|
Библиотека |
|
DLL |
|