CInternetConnection 類別
管理您與網際網路伺服器的連接。
語法
class CInternetConnection : public CObject
成員
公用建構函式
名稱 | 描述 |
---|---|
CInternetConnection::CInternetConnection | 建構 CInternetConnection 物件。 |
公用方法
名稱 | 描述 |
---|---|
CInternetConnection::GetContext | 取得這個連接物件的內容識別碼。 |
CInternetConnection::GetServerName | 取得與連接相關聯的伺服器名稱。 |
CInternetConnection::GetSession | 取得與連接相關聯的 CInternetSession 物件的指標。 |
公用運算子
名稱 | 描述 |
---|---|
CInternetConnection::operator HINTERNET | 因特網會話的句柄。 |
備註
它是 MFC 類別 CFtpConnection、CHttpConnection 和 CGopherConnection 的基類。 每個類別都提供與個別 FTP、HTTP 或 gopher 伺服器通訊的其他功能。
若要直接與因特網伺服器通訊,您必須有 CInternetSession 對象和 CInternetConnection
物件。
若要深入瞭解 WinInet 類別的運作方式,請參閱使用 WinInet 進行因特網程序設計一文。
繼承階層架構
CInternetConnection
需求
標頭: afxinet.h
CInternetConnection::CInternetConnection
建立 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 從建立 InternetConnection 衍生物件的 CInternetSession 物件傳送至CInternetConnection
衍生物件。 預設值設定為 1;不過,您可以在連線的 CInternetSession 建構函式中明確指派特定內容識別碼。 物件及其執行的任何工作都會與該內容識別碼相關聯。 內容標識符會傳回至 CInternetSession::OnStatusCallback ,以提供識別物件的狀態。 如需內容標識碼的詳細資訊,請參閱因特網第一個步驟:WinInet 一文。
CInternetConnection::GetContext
呼叫此成員函式以取得此會話的內容標識碼。
DWORD_PTR GetContext() const;
傳回值
應用程式指派的內容識別碼。
備註
內容標識元最初是在 CInternetSession 中指定,並傳播至 CInternetConnection
- 和 CInternetFile 衍生類別,除非在呼叫開啟連線的函式中以不同方式指定。 內容標識符與指定物件的任何作業相關聯,並識別 CInternetSession::OnStatusCallback 所傳回的作業狀態資訊。
如需如何使用GetContext
其他 WinInet 類別來提供用戶狀態資訊的詳細資訊,請參閱因特網第一步:WinInet 一文,以取得內容標識碼的詳細資訊。
CInternetConnection::GetServerName
呼叫此成員函式,以取得與此因特網連線相關聯的伺服器名稱。
CString GetServerName() const;
傳回值
這個連接物件正在使用的伺服器名稱。
CInternetConnection::GetSession
呼叫這個成員函式,以取得與這個連接相關聯之物件的指標 CInternetSession
。
CInternetSession* GetSession() const;
傳回值
與此因特網連接對象相關聯的 CInternetSession 物件的指標。
CInternetConnection::operator HINTERNET
使用此運算子可取得目前因特網會話的 API 層級句柄。
operator HINTERNET() const;