IWinHttpRequest：：SetTimeouts 方法
SetTimeouts方法會以毫秒為單位指定傳送/接收作業的個別逾時元件。
語法
HRESULT SetTimeouts(
[in] long ResolveTimeout,
[in] long ConnectTimeout,
[in] long SendTimeout,
[in] long ReceiveTimeout
);
參數
-
ResolveTimeout [in]
-
解析主機名稱 (時套用的逾時值，例如
www.microsoft.com) 為 IP 位址 (，以毫秒為單位，例如 192.168.131.199) 。 預設值為零，表示無逾時 (無限) 。 如果使用 NAME_RESOLUTION_TIMEOUT指定 DNS 逾時，則每個要求會有一個執行緒的額外負荷。 -
ConnectTimeout [in]
-
使用目標伺服器建立通訊通訊端時套用的逾時值，以毫秒為單位。 預設值為 60，000 (60 秒) 。
-
SendTimeout [in]
-
將通訊通訊端上的個別要求資料封包傳送至目標伺服器時，以毫秒為單位套用逾時值。 傳送至 HTTP 伺服器的大型要求通常會分成多個封包;傳送逾時適用于個別傳送每個封包。 預設值為 30，000 (30 秒) 。
-
ReceiveTimeout [in]
-
從目標伺服器接收回應資料的封包時，以毫秒為單位套用逾時值。 大型回應會分成多個封包;接收逾時適用于從通訊端擷取每個資料封包。 預設值為 30，000 (30 秒) 。
傳回值
傳回值會在成功或錯誤值時 S_OK ，否則傳回值。
備註
全部都是必要參數。 值為 0 或 -1 會將逾時設定為無限等候。 大於 0 的值會以毫秒為單位設定逾時值。 例如，30，000 會將逾時設定為 30 秒。 -1 以外的所有負值都會導致這個方法失敗。
逾時值會套用至 Winsock 層。
注意
針對 Windows XP 和 Windows 2000，請參閱 WinHttp 起始頁面的 執行時間需求 一節。
範例
下列範例示範如何將所有 WinHTTP 逾時設定為 30 秒、開啟 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))
{ // Set Time-outs.
hr = pIWinHttpRequest->SetTimeouts(30000, 30000,
30000, 30000);
}
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->GetAllResponseHeaders(&bstrResponse);
}
if (SUCCEEDED(hr))
{ // Print response to console.
wprintf(L"%.256s",bstrResponse);
}
// Release memory.
if (pIWinHttpRequest)
pIWinHttpRequest->Release();
if (bstrResponse)
SysFreeString(bstrResponse);
CoUninitialize();
return 0;
}
下列腳本範例示範如何將所有 WinHTTP 逾時設定為 30 秒、開啟 HTTP 連線，以及傳送 HTTP 要求。
// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
// Set time-outs. If time-outs are set, they must
// be set before open.
WinHttpReq.SetTimeouts(30000, 30000, 30000, 30000);
// Initialize an HTTP request.
WinHttpReq.Open("GET", "https://www.microsoft.com", false);
// Send the HTTP request.
WinHttpReq.Send();
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
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 |
|