HttpSendRequest

HttpSendRequest，Windows WinINet系列API函式之一，該函式用於傳送HTTP請求到指定的伺服器。

基本介紹

• 外文名：HttpSendRequest
• 類型：API函式
• 用途：傳送HTTP請求到指定的伺服器
• 返回值：TRUE/FALSE

簡述

此函式傳送HTTP請求到指定的伺服器。

語法

BOOL WINAPI HttpSendRequest(　    HINTERNET hRequest, 　    LPCTSTR lpszHeaders, 　    DWORD dwHeadersLength, 　    LPVOID lpOptional, 　    DWORD dwOptionalLength　);

參數

參數

描述

hRequest

[]打開HTTP請求返回的句柄。

lpszHeaders

[]長指針以null結尾的字元串，包含額外的頭被追加到請求。 此參數可以為NULL，如果沒有額外的頭追加。 請參閱備註

dwHeadersLength

[in]指定的長度，字元，額外的標頭。 如果這個參數是-1L和lpszHeaders不為NULL，則該函式假定的lpszHeaders零結尾（ASCIIZ），計算長度。 請參閱備註

lpOptional

[]任何可選的數據傳送後，立即請求頭指針。 該參數通常用於POST和PUT操作。 可選的數據可以被傳送到伺服器的資源或信息。 如果沒有可選的數據傳送，此參數可以為NULL。

dwOptionalLength

[in]指定選購的數據的長度，以位元組為單位。 如果沒有可選的數據要傳送時，這個參數可以是零。

返回值

TRUE表示成功。 FALSE表示失敗。 可調用GetLastError函式，得到錯誤信息。

備註

這個函式有兩個版本使用HttpSendRequestA ANSI版本和Unicode版本一起使用HttpSendRequestW。 如果該值dwHeadersLength-1L和lpszHeaders的值不為NULL，被稱為HttpSendRequestA時，該函式假定lpszHeaders零結尾（ASCIIZ），計算長度。 當HttpSendRequestW這些值，調用函式將失敗，ERROR_INVALID_PARAMETER。
此功能的HTTP伺服器傳送指定的請求，並允許客戶端指定另外的頭與請求一起傳送。
該功能還可以讓客戶端指定可選的數據傳送到HTTP伺服器請求頭緊隨。 該特徵通常用於“寫”操作，如PUT和POST。
傳送請求後，從HTTP伺服器的狀態代碼和回響報頭被讀取。 這些頭在內部進行維護，並提供給客戶端應用程式通過HttpQueryInfo功能。
應用程式可以使用相同的HTTP請求句柄多次調用HttpSendRequest ，但應用程式必須讀取從以前再次調用該函式之前調用返回的所有數據。
在離線模式下，HttpSendRequest返回ERROR_FILE_NOT_FOUND如果沒有找到資源，在網際網路高速快取中。 此功能的HTTP伺服器傳送指定的請求，並允許客戶端指定另外的頭與請求一起傳送。