HttpOpenRequestW 函式 (wininet.h)
建立 HTTP 要求句柄。
語法
HINTERNET HttpOpenRequestW(
[in] HINTERNET hConnect,
[in] LPCWSTR lpszVerb,
[in] LPCWSTR lpszObjectName,
[in] LPCWSTR lpszVersion,
[in] LPCWSTR lpszReferrer,
[in] LPCWSTR *lplpszAcceptTypes,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
參數
[in] hConnect
InternetConnect 所傳回之 HTTP 會話的句柄。
[in] lpszVerb
Null 終止字串的指標,其中包含要求中使用的 HTTP 動詞。 如果此參數為 NULL,函式會使用 GET 作為 HTTP 動詞。
[in] lpszObjectName
Null 終止字串的指標,其中包含指定之 HTTP 動詞動詞之目標對象的名稱。 這通常是檔名、可執行模組或搜尋規範。
[in] lpszVersion
Null 終止字串的指標,其中包含要求中使用的 HTTP 版本。 Internet Explorer 中的設定會覆寫此參數中指定的值。
如果此參數為 NULL,則函式會根據 Internet Explorer 設定的值,使用 HTTP 版本 1.1 或 1.0。
值 | 意義 |
---|---|
|
HTTP 1.0 版 |
|
HTTP 1.1 版 |
[in] lpszReferrer
Null 終止字串的指標,指定從中取得要求 (lpszObjectName) URL 的檔 URL。 如果此參數為 NULL,則未指定任何參照者。
[in] lplpszAcceptTypes
字串的 Null 終止陣列指標,表示用戶端接受的媒體類型。 範例如下。
PCTSTR rgpszAcceptTypes[] = {_T("text/*"), NULL};
若無法以 NULL 指標正確終止數位,將會導致當機。
如果此參數為 NULL,則用戶端不會接受任何類型。 伺服器通常會解譯缺少接受類型,以指出用戶端只接受類型為 「text/*」 (的檔,也就是只有文字檔—沒有圖片或其他二進位檔) 。
[in] dwFlags
因特網選項。 此參數可以是下列任何值。
值 | 意義 |
---|---|
|
如果資源的網路要求因為伺服器ERROR_INTERNET_CONNECTION_RESET (联机已重设) 或ERROR_INTERNET_CANNOT_CONNECT (尝试联机到服务器失败,則傳回快取的資源) 。 |
|
在判斷是否要從網路重載專案時,強制重載沒有 「到期時間」,且沒有從伺服器傳回的 LastModified 時間。 |
|
針對要求中指定的主機名,停用從伺服器傳回的SSL/PCT型憑證檢查。 WinINet 函式會藉由比較相符的主機名和簡單的通配符規則,對憑證使用簡單的檢查。 |
|
停用 SSL/PCT 型憑證的檢查,以取得適當的有效日期。 |
|
停用這種特殊重新導向類型的偵測。 使用此旗標時,WinINet 函式會以透明方式允許從 HTTPS 重新導向至 HTTP URL。 |
|
停用這種特殊重新導向類型的偵測。 使用此旗標時,WinINet 函式會以透明方式允許從 HTTP 重新導向至 HTTPS URL。 |
|
如果連線可用,請使用保持運作語意。 Microsoft Network (MSN) 、NT LAN Manager (NTLM) ,以及其他類型的驗證都需要此旗標。 |
|
如果無法快取檔案,就會建立臨時檔。 |
|
不會自動嘗試驗證。 |
|
不會自動處理 HttpSendRequest 中的重新導向。 |
|
不會將傳回的實體新增至快取。 |
|
不會自動將 Cookie 標頭新增至要求,也不會自動將傳回的 Cookie 新增至 Cookie 資料庫。 |
|
停用 Cookie 對話框。 |
|
強制源伺服器解析要求,即使 Proxy 上有快取的複本也一樣。 |
|
強制從源伺服器下載要求的檔案、對象或目錄清單,而不是從快取下載。 |
|
如果資源自上次下載後已修改,則會重載 HTTP 資源。 所有 FTP 資源都會重載。
Windows XP 和 Windows Server 2003 R2 和更早版本: Gopher 資源也會重載。 |
|
使用安全交易語意。 這可轉譯為使用安全套接字層/私人通訊技術 (SSL/PCT) ,而且只在 HTTP 要求中有意義。 |
[in] dwContext
變數的指標,其中包含應用程式定義的值,這個值會將這項作業與任何應用程式數據產生關聯。
傳回值
如果成功,則傳回 HTTP 要求句柄,否則傳回 NULL 。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError。
備註
HttpOpenRequest 函式會建立新的 HTTP 要求句柄,並將指定的參數儲存在該句柄中。 HTTP 要求句柄會保留要傳送至 HTTP 伺服器的要求,並包含要作為要求一部分傳送的所有 RFC822/MIME/HTTP 標頭。
如果指定了 「GET」 或 「POST」 以外的動詞, HttpOpenRequest 會自動設定要求INTERNET_FLAG_NO_CACHE_WRITE和INTERNET_FLAG_RELOAD。
使用 Microsoft Internet Explorer 5 和更新版本時,如果 lpszVerb 設定為 “HEAD”,則會在 HTTP/1.1 伺服器的回應上忽略 Content-Length 標頭。
在 Windows 7、Windows Server 2008 R2 及更新版本上,Internet Explorer 設定會覆寫 lpszVersion 參數。 EnableHttp1_1是系統 Internet Explorer 中設定的 Internet Options 所控制的 HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE 下的登錄值。 EnableHttp1_1值預設值為1。 如果EnableHttp1_1設定為1,HttpOpenRequest 函式會將小於1.1的任何 HTTP 版本升級為 HTTP 1.1 版。
呼叫應用程式使用 HttpOpenRequest 傳回的 HINTERNET 句柄完成之後,必須使用 InternetCloseHandle 函式加以關閉。
注意在異步模式中傳送要求時, (InternetOpen 的 dwFlags 參數會指定 INTERNET_FLAG_ASYNC) ,而 dwContext 參數為零 (INTERNET_NO_CALLBACK) ,則不會叫用在要求句柄上使用 InternetSetStatusCallback 設定的回呼函式,不過,呼叫仍會在異步模式中執行。
就像 WinINet API 的其他所有層面一樣,無法在 DllMain 或全域物件的建構函式和解構函式內安全地呼叫此函式。
注意
wininet.h 標頭會將 HttpOpenRequest 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wininet.h |
程式庫 | Wininet.lib |
Dll | Wininet.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應