InternetOpenUrlA 函式 (wininet.h)
開啟由完整 FTP 或 HTTP URL 指定的資源。
語法
HINTERNET InternetOpenUrlA(
[in] HINTERNET hInternet,
[in] LPCSTR lpszUrl,
[in] LPCSTR lpszHeaders,
[in] DWORD dwHeadersLength,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
參數
[in] hInternet
目前網際網路會話的控制碼。 先前呼叫 InternetOpen時，必須傳回控制碼。
[in] lpszUrl
Null終止字串變數的指標，指定要開始讀取的 URL。 僅支援開頭為 ftp：、HTTP：或 HTTPs： 的 URL。
[in] lpszHeaders
Null終止字串的指標，指定要傳送至 HTTP 伺服器的標頭。 如需詳細資訊，請參閱HttpSendRequest函式中的lpszHeaders參數描述。
[in] dwHeadersLength
TCHAR中其他標頭的大小。 如果此參數為 -1L 且 lpszHeaders 不是 Null， 則會假設 lpszHeaders 為零終止 (ASCIIZ) ，並計算長度。
[in] dwFlags
此參數可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
如果現有的 InternetConnect 物件存在，且具有提出要求所需的相同屬性，就會嘗試使用現有的 InternetConnect 物件。 這只適用于 FTP 作業，因為 FTP 是唯一在相同會話期間執行多個作業的通訊協定。 WinINet API 會針對InternetOpen所產生的每個HINTERNET控制碼快取單一連線控制碼。 InternetOpenUrl 會針對 HTTP 和 FTP 連線使用此旗標。 |
|
判斷是否要從網路重載專案時，如果沒有 Expires 時間，且伺服器未傳回 LastModified 時間，則強制重載。 |
|
針對要求中指定的主機名稱，停用從伺服器傳回的 SSL/PCT 憑證檢查。 WinINet 函式會藉由比較相符的主機名稱和簡單的萬用字元規則，針對憑證使用簡單的檢查。 |
|
停用 SSL/PCT 型憑證的檢查，以取得適當的有效日期。 |
|
停用這種特殊重新導向類型的偵測。 使用此旗標時，WinINet 會以透明方式允許從 HTTPS 重新導向至 HTTP URL。 |
|
停用此特殊重新導向類型的偵測。 使用此旗標時，WinINet 會以透明方式允許從 HTTP 重新導向至 HTTPS URL。 |
|
如果有的話，請使用連線的 Keep-alive 語意。 Microsoft 網路 (MSN) 、NTLM 和其他驗證類型都需要此旗標。 |
|
如果無法快取檔案，就會建立暫存檔案。 |
|
不會自動嘗試驗證。 |
|
不會自動處理 HttpSendRequest中的重新導向。 |
|
不會將傳回的實體新增至快取。 |
|
不會自動將 Cookie 標頭新增至要求，也不會自動將傳回的 Cookie 新增至 Cookie 資料庫。 |
|
停用 Cookie 對話方塊。 |
|
使用被動 FTP 語意。 InternetOpenUrl 會針對 FTP 檔案和目錄使用此旗標。 |
|
強制源伺服器解析要求，即使 Proxy 上有快取的複本也一樣。 |
|
擷取 FTP 目錄資訊時，以 WIN32_FIND_DATA 結構傳回資料。 如果未指定此旗標，或透過 CERN Proxy 進行呼叫， InternetOpenUrl 會傳回目錄的 HTML 版本。
Windows XP 和 Windows Server 2003 R2 和更早版本： 擷取 Gopher 目錄資訊時，也會以 GOPHER_FIND_DATA 結構的形式傳回資料。 |
|
強制從源伺服器下載要求的檔案、物件或目錄清單，而不是從快取下載。 |
|
如果資源自上次下載後已修改，則會重載 HTTP 資源。 所有 FTP 資源都會重載。
Windows XP 和 Windows Server 2003 R2 和更早版本： Gopher 資源也會重載。 |
|
使用安全交易語意。 這會轉譯為使用安全通訊端層/私人通訊技術 (SSL/PCT) ，而且只有在 HTTP 要求中才有意義。 |
[in] dwContext
變數的指標，指定傳遞給任何回呼函式的應用程式定義值以及傳回的控制碼。
傳回值
如果成功建立連線，則會傳回 URL 的有效控制碼，如果連線失敗則傳回 Null 。 若要擷取特定的錯誤訊息，請呼叫 GetLastError。 若要判斷為何拒絕存取服務，請呼叫 InternetGetLastResponseInfo。
備註
如果使用的 URL 包含相對 URL 和以空格分隔的基底 URL，請先呼叫 InternetCanonicalizeUrl 。
這是應用程式可用來透過 WinINet 支援的任何通訊協定擷取資料的一般函式。 當應用程式不需要存取通訊協定的特定資料，但只需要對應至 URL 的資料時，此函式特別有用。 InternetOpenUrl函式會剖析 URL 字串、建立與伺服器的連線，並準備下載 URL 所識別的資料。 然後，應用程式可以使用 InternetReadFile (來擷取 URL 資料的目錄) 或 InternetFindNextFile) (。 在InternetOpenUrl之前，不需要呼叫InternetConnect。
Windows XP 和 Windows Server 2003 R2 和更早版本： InternetOpenUrl 會在小於 1024 的埠上停用 Gopher，但埠 70 除外，標準 Gopher 埠和埠 105，通常用於中央服務組織 (CSO) 名稱搜尋。
呼叫應用程式使用InternetOpenUrl所傳回的HINTERNET控制碼完成之後，必須使用InternetCloseHandle函式來關閉它。
注意在非同步模式中工作時， (InternetOpen的dwFlags參數會指定INTERNET_FLAG_ASYNC) ，而dwCoNtext參數是零 (INTERNET_NO_CALLBACK) ，則不會叫用會話控制碼上以InternetSetStatusCallback設定的回呼函式，不過，呼叫仍會在非同步模式中執行
就像 WinINet API 所有其他層面一樣，您無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。
注意
wininet.h 標頭會將 InternetOpenUrl 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平臺 | Windows |
| 標頭 | wininet.h |
| 程式庫 | Wininet.lib |
| DLL | Wininet.dll |