CInternetSession::CInternetSession

CInternetSession ,在建立物件時,這個呼叫成員函式。

CInternetSession(
   LPCTSTR pstrAgent = NULL,
   DWORD_PTR dwContext = 1,
   DWORD dwAccessType = PRE_CONFIG_INTERNET_ACCESS,
   LPCTSTR pstrProxyName = NULL,
   LPCTSTR pstrProxyBypass = NULL,
   DWORD dwFlags = 0 
);

參數

  • pstrAgent
    對於識別呼叫網際網路功能的字串的指標, 「(Microsoft 網際網路瀏覽器」) 的應用程式或實體的名稱。如果 pstrAgent 是 NULL (預設值),架構會呼叫全域函式 AfxGetAppName,傳回包含應用程式名稱的 NULL 結尾字串。某些通訊協定會使用這個字串會識別您的應用程式至伺服器。

  • dwContext
    作業的內容識別項。dwContext 識別 CInternetSession::OnStatusCallback傳回的作業的狀態資訊。預設設定為 1;不過,您可以明確指派作業的特定內容 ID。物件和它的所有工作都會與該內容 ID.

  • dwAccessType
    需要的存取類型。下列是有效值,其中一個可能就會提供:

    • 使用在登錄中,的預先設定的設定INTERNET_OPEN_TYPE_PRECONFIG 連接。這種存取型別設定為預設值。藉由 TIS Proxy 要連接,請將 dwAccessType 為這個值,然後您適當地設定登錄。

    • INTERNET_OPEN_TYPE_DIRECT 直接連接至網際網路。

    • INTERNET_OPEN_TYPE_PROXY 傳遞 CERN Proxy 連接。

    如需連接以 Proxy 的不同類型的詳細資訊,請參閱 在典型 FTP 用戶端應用程式的步驟。

  • pstrProxyName
    慣用的 CERN Proxy 的名稱,如果 dwAccessType 設定為 INTERNET_OPEN_TYPE_PROXY。預設值為 NULL

  • pstrProxyBypass
    含有伺服器位址一份選擇性的字串的指標。當使用 Proxy 存取時,這些位址可能會被略過。如果提供 NULL 值,略過清單從登錄讀取。只有在 dwAccessType 設為 INTERNET_OPEN_TYPE_PROXY,這個參數是有意義的。

  • dwFlags
    表示各種快取選項。預設值為 0。可能值包括:

    • INTERNET_FLAG_DONT_CACHE 不會快取資料,而則會在任何或入口網站伺服器。

    • INTERNET_FLAG_OFFLINE 下載作業只能透過保存快取回應的。如果項目不存在於快取中,適當的錯誤碼傳回。這個旗標可使用位元的 OR 運算結合 OR (|) 運算子。

備註

CInternetSession 為應用程式呼叫的第一個網際網路功能。它初始化內部資料結構以及從應用程式的後續呼叫。

如果無法開啟網際網路連接, CInternetSession 擲回 AfxThrowInternetException

範例

CFtpFileFind。請參閱範例。

需求

Header: afxinet.h

請參閱

參考

CInternetSession 類別

階層架構圖

CInternetSession::Close

CInternetSession::EnableStatusCallback

CInternetSession::GetContext