共用方式為

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 進行網際網路程式設計一文 。

繼承階層架構

CObject

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;

另請參閱

CObject 類別
階層架構圖表