InternetOpenUrl

InternetOpenUrl,計算機程式語言函式,見於C++語言。

HINTERNET InternetOpenUrl
( HINTERNET hInternet ,
LPCTSTR lpszUrl ,
LPCTSTR lpszHeaders ,
DWORD dwHeadersLength ,
DWORD dwFlags ,
DWORD_PTR dwContext)
通過一個完整的FTP,Gopher或HTTP網址打開一個資源。
參數
hInternet
當前的 Internet 會話句柄。句柄必須由前期的 InternetOpen 調用返回。
lpszUrl
一個空字元結束的字元串變數的指針,指定讀取的網址。只有以ftp:, gopher:, http:, 或者 https: 開頭的網址被支持。
lpszHeaders
一個空字元結束的字元串變數的指針,指定傳送到HTTP伺服器的頭信息。欲了解更多信息,請參閱HttpSendRequest函數裡lpszHeaders參數的說明。
dwHeadersLength
額外的頭的大小,以TCHAR為單位。如果這個參數是-1L並且lpszHeaders不是NULL,lpszHeaders被假設為零終止( ASCIIZ ),而長度被自動計算。
dwFlags
此參數可為下列值之一。
數值 說明
INTERNET_FLAG_EXISTING_CONNECT
如果使用相同的必須屬性創建會話,會嘗試利用現有的InternetConnect對象。這隻對FTP操作非常有用,因為FTP是唯一在同一會話中執行多種操作的協定。WinINet API 為每個由InternetOpen產生的HINTERNET句柄緩衝一個單獨連結句柄。InternetOpenUrl使用此標誌的HTTP和FTP連線。
INTERNET_FLAG_HYPERLINK
當決定何時從網路重載時,如果伺服器沒有返回 expires time 和 LastModified,那么強制重載。
INTERNET_FLAG_IGNORE_CERT_CN_INVALID
停用檢查從伺服器對必須的主機名稱返回的SSL/PCT-based證書。 WinINet函式使用簡單的比較匹配主機名稱和通配符的規則檢查證書。
INTERNET_FLAG_IGNORE_CERT_DATE_INVALID
停用檢查的SSL/PCT-based的證書的適當的有效日期。
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP
禁用檢測這中特殊的重定向。當使用此標誌, WinINet 透明允許從HTTPS到HTTP URL的重定向。
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS
禁用檢測這中特殊的重定向。當使用此標誌, WinINet 透明的允許的HTTP到HTTPS URL的重定向。
INTERNET_FLAG_KEEP_CONNECTION
如果可能的話,為連線使用保活語義。這個標誌要求微軟網路( MSN ),NTLM和其他類型的身份驗證。
INTERNET_FLAG_NEED_FILE
如果要創建的檔案不能被快取,創建臨時檔案。
INTERNET_FLAG_NO_AUTH
不試圖自動驗證。
INTERNET_FLAG_NO_AUTO_REDIRECT
不自動處理HttpSendRequest中的重定向。
INTERNET_FLAG_NO_CACHE_WRITE
不添加返回實體到快取。
INTERNET_FLAG_NO_COOKIES
不會自動添加的Cookie頭到請求,並且不自動添加返回的cookie到cookie資料庫。
INTERNET_FLAG_NO_UI
禁用Cookie的對話框。
INTERNET_FLAG_PASSIVE
使用被動FTP語義。InternetOpenUrl為FTP的檔案和目錄使用此標誌。
INTERNET_FLAG_PRAGMA_NOCACHE
即使代理中存在快取副本,也強制要求由源伺服器返回。
INTERNET_FLAG_RAW_DATA
檢索的Gopher目錄信息時,傳回的數據作為GOPHER_FIND_DATA結構,如果檢索的FTP目錄信息時,作為一個WIN32_FIND_DATA結構。如果此標誌沒有指定,或者請求通過CERN代理創建, InternetOpenUrl返回的HTML版本的目錄。
INTERNET_FLAG_RELOAD
從原伺服器強制下載所要求的檔案,對象,或目錄列表,而不是從快取下載。
INTERNET_FLAG_RESYNCHRONIZE
重新載入的HTTP資源,如果資源在最後一次下載後已被修改。所有FTP和Gopher資源將被重載。
INTERNET_FLAG_SECURE
使用安全傳輸語義。這次傳輸使用安全套位元組層/專用通信技術(的SSL / PCT ),這隻有在HTTP請求時有意義。
dwContext
一個指向一個應用程式定義的值,將隨著返回的句柄,一起傳遞給回調函式。
返回值
如果已成功建立到FTP,Gopher,或HTTP URL的連線,返回一個有效的句柄,如果連線失敗返回NULL。要檢索特定的錯誤訊息,請GetLastError 。要確定為什麼對伺服器的訪問被拒絕,請調用InternetGetLastResponseInfo。
備註
先調用InternetCanonicalizeUrl,如果正在使用的網址包含一個相對URL和一個空格分隔的基礎URL。
這是一個通用的函式,可用於使用任何WinINet支持的協定檢索數據。這個函式在應用程式並不需要指定特定的協定,只需要相應的URL的數據時,特別有用。InternetOpenUrl函式解析URL字元串,建立連線到伺服器,並準備下載的指定URL的數據。該應用程式可以用InternetReadFile (對檔案)或InternetFindNextFile (對目錄)來檢索URL的數據。沒有必要在InternetOpenUrl 前調用InternetConnect。
InternetOpenUrl在少於1024連線埠上禁用Gopher,除了70——標準的Gopher連線埠和105——通常用於中央服務組織(民間組織)的名字搜尋。
在使用完InternetOpenUrl返回的HINTERNET句柄後,必須使用InternetCloseHandle函式關閉它。
注意 :當工作在異步模式(InternetOpen的dwFlags參數指定INTERNET_FLAG_ASYNC)和dwContext參數是零 (INTERNET_NO_CALLBACK),使用InternetSetStatusCallback函式設定的回調,將不被引用,但是,將仍然在異步模式執行回調。
要求
客戶端
需要 Windows Vista, Windows XP, Windows 2000 Professional, Windows NT Workstation 4.0, Windows Me, Windows 98, 或者 Windows 95。
伺服器-
需要 Windows Server 2008, Windows Server 2003, Windows 2000 Server, 或 Windows NT Server 4.0
版本:
需要 Internet Explorer 3.0 或更高版本。

在 Wininet.h 中聲明。

使用 Wininet.lib 。
DLL
需要 wininet.dll
Unicode
執行InternetOpenUrlW(Unicode)和InternetOpenUrlA (ANSI) 的。

相關詞條

相關搜尋

熱門詞條

聯絡我們