CInternetSession::OpenURL
呼叫此成員函式會傳送要求給指定的 HTTP 伺服器並允許用戶端指定其他 RF C822, MIME 或 HTTP 標頭與要求一起傳送。
CStdioFile* OpenURL(
LPCTSTR pstrURL,
DWORD_PTR dwContext = 1,
DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII,
LPCTSTR pstrHeaders = NULL,
DWORD dwHeadersLength = 0
);
參數
pstrURL
要啟動的 URL 名稱的指標讀取。 以 file:、ftp:、gopher:或 http 開始只 URL:支援。 ASSERTS ,如果 pszURL 是 NULL。dwContext
應用程式定義的值通過與回呼傳回的控制代碼。dwFlags
描述如何的旗標處理這個連接。 請參閱 備註 有關有效旗標的詳細資訊。 有效旗標為:INTERNET_FLAG_TRANSFER_ASCII 預設值。 將檔案在 ASCII 文字。
INTERNET_FLAG_TRANSFER_BINARY 傳輸檔案為二進位檔案。
INTERNET_FLAG_RELOAD Get 從所建立,即使其快取在本機上。
INTERNET_FLAG_DONT_CACHE 不會快取資料,在本機上或任何入口網站。
INTERNET_FLAG_SECURE 這個旗標只適合 HTTP 要求。 它需要連線上的安全交易使用 Secure Sockets Layer 或 PCT。
如果可能,INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT 重複使用於伺服器上的現有連接 OpenUrl 產生新的要求而不是為每個連接要求的新工作階段。
INTERNET_FLAG_PASSIVE 為 FTP 站台上使用。 使用被動 FTP 語意。 使用 OpenURLCInternetConnection 。
pstrHeaders
out 包含標頭的字串的指標傳送到 HTTP 伺服器。dwHeadersLength
的長度,以字元為單位,其他標頭。 如果這是-1L,並 pstrHeaders 是非NULL,則 pstrHeaders 假設為結尾的零,且長度計算。
傳回值
只傳回 FTP、HTTP 和 Gopher、文件類型網際網路服務之檔案控制代碼。 如果剖析不成功,則傳回 NULL 。
OpenURL 傳回的指標取決於 pszURL 的服務型別。 下表說明 OpenURL 可以傳回的指標。
URL 型別 |
傳回 |
---|---|
file:// |
CStdioFile* |
http:// |
CHttpFile* |
gopher:// |
CGopherFile* |
ftp:// |
CInternetFile* |
備註
參數 dwFlags 必須包含 INTERNET_FLAG_TRANSFER_ASCII 或 INTERNET_FLAG_TRANSFER_BINARY,,但不能同時指定兩者。 保留的旗標可以結合了位元運算子 ( OR |).
OpenURL,包裝 Win32 函式 InternetOpenURL,允許下載,只擷取和讀取資料從網際網路伺服器。 OpenURL 不允許位於遠端位置的資料作業,因此,它不需要 CInternetConnection 物件。
若要使用連接特定 (即) 通訊協定的特定功能,例如寫入檔案,您在所需的模式必須啟動工作階段,然後開啟特定種類的連接,然後使用該連接來開啟檔案。 請參閱 CInternetConnection 有關連接特定函式的詳細資訊。
例外狀況
這個方法會擲回型別 **CInternetException***的例外狀況。
需求
Header: afxinet.h