共用方式為


CInternetConnection 類別

管理您與網際網路伺服器的連接。

語法

class CInternetConnection : public CObject

成員

公用建構函式

名稱 描述
CInternetConnection::CInternetConnection 建構 CInternetConnection 物件。

公用方法

名稱 描述
CInternetConnection::GetContext 取得這個連接物件的內容識別碼。
CInternetConnection::GetServerName 取得與連接相關聯的伺服器名稱。
CInternetConnection::GetSession 取得與連接相關聯的 CInternetSession 物件的指標

公用運算子

名稱 描述
CInternetConnection::operator HINTERNET 因特網會話的句柄。

備註

它是 MFC 類別 CFtpConnection、CHttpConnectionCGopherConnection 的基類。 每個類別都提供與個別 FTP、HTTP 或 gopher 伺服器通訊的其他功能。

若要直接與因特網伺服器通訊,您必須有 CInternetSession 對象和 CInternetConnection 物件。

若要深入瞭解 WinInet 類別的運作方式,請參閱使用 WinInet 進行因特網程序設計一文

繼承階層架構

CObject

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;

另請參閱

CObject 類別
階層架構圖表