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
HttpRequest.idl
程式庫
WinHTTP.lib
DLL
Winhttp.dll

另請參閱

IWinHttpRequest

WinHttpRequest

WinHTTP 版本