CInternetConnection 類別
管理您與網際網路伺服器的連接。
語法
class CInternetConnection : public CObject
成員
公用建構函式
名稱 | 描述 |
---|---|
CInternet連線ion::CInternet連線ion | 建構 CInternetConnection 物件。 |
公用方法
名稱 | 描述 |
---|---|
CInternet連線ion::GetCoNtext | 取得這個連線物件的內容識別碼。 |
CInternet連線ion::GetServerName | 取得與連接相關聯的伺服器名稱。 |
CInternet連線ion::GetSession | 取得與連接相關聯的 CInternetSession 物件的指標 。 |
公用運算子
名稱 | 描述 |
---|---|
CInternet連線ion::operator HINTERNET | 網際網路會話的控制碼。 |
備註
它是 MFC 類別 CFtp連線ion 、 CHttp連線ion 和 CGopher連線ion 的基類。 每個類別都提供與個別 FTP、HTTP 或 Gopher 伺服器通訊的其他功能。
若要直接與網際網路伺服器通訊,您必須有 CInternetSession 物件和 CInternetConnection
物件。
若要深入瞭解 WinInet 類別的運作方式,請參閱使用 WinInet 進行網際網路程式設計一文 。
繼承階層架構
CInternetConnection
需求
標頭: afxinet.h
CInternet連線ion::CInternet連線ion
建立物件時 CInternetConnection
會呼叫這個成員函式。
CInternetConnection(
CInternetSession* pSession,
LPCTSTR pstrServer,
INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
DWORD_PTR dwContext = 1);
參數
pSession
CInternetSession 物件的指標 。
pstrServer
包含伺服器名稱之字串的指標。
nPort
識別此連線之網際網路埠的數位。
dwCoNtext
物件的內容識別碼 CInternetConnection
。 如需 dwCoNtext 的詳細資訊 , 請參閱 。
備註
您永遠不會自行呼叫 CInternetConnection
,而是針對您想要建立的連線類型呼叫 CInternetSession 成員函式:
dwCoNtext 的 預設值會由 MFC 從建立 網際網路連線衍生 物件的 CInternetSession 物件傳送至 CInternetConnection
衍生 物件。 預設值設定為 1;不過,您可以在連線的 CInternetSession 建構函式中明確指派特定內容識別碼。 物件及其執行的任何工作都會與該內容識別碼相關聯。 內容識別碼會傳回至 CInternetSession::OnStatusCallback ,以提供識別物件的狀態。 如需內容識別碼的詳細資訊,請參閱網際網路第一個步驟:WinInet 一文 。
CInternet連線ion::GetCoNtext
呼叫此成員函式以取得此會話的內容識別碼。
DWORD_PTR GetContext() const;
傳回值
應用程式指派的內容識別碼。
備註
內容識別碼最初是在 CInternetSession 中 指定,並傳播至 CInternetConnection
- 和 CInternetFile 衍生類別,除非在呼叫開啟連線的函式中以不同方式指定。 內容識別碼與指定物件的任何作業相關聯,並識別 CInternetSession::OnStatusCallback 所傳 回的作業狀態資訊。
如需如何使用 GetContext
其他 WinInet 類別來提供使用者狀態資訊的詳細資訊,請參閱網際網路第一步:WinInet 一文 ,以取得內容識別碼的詳細資訊。
CInternet連線ion::GetServerName
呼叫此成員函式,以取得與此網際網路連線相關聯的伺服器名稱。
CString GetServerName() const;
傳回值
這個連線物件正在使用的伺服器名稱。
CInternet連線ion::GetSession
呼叫這個成員函式,以取得與這個連接相關聯之物件的指標 CInternetSession
。
CInternetSession* GetSession() const;
傳回值
與此網際網路連線物件相關聯的 CInternetSession 物件的指標 。
CInternet連線ion::operator HINTERNET
使用此運算子可取得目前網際網路會話的 API 層級控制碼。
operator HINTERNET() const;
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應