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