WinInet 程式設計：CInternetSession 實作 HTTP/FTP 客戶端完整指南

WinInet 與 MFC 封裝層次

WinInet (wininet.dll) 為系統級 HTTP/FTP/Gopher 客戶端庫，整合 IE 設定（Proxy、快取、Cookie）。MFC 提供三層封裝：

• 核心會話類： CInternetSession — 管理連線設定、回呼、全域狀態。
• 連線類： CHttpConnection、CFtpConnection、CGopherConnection — 代表與特定伺服器的會話。
• 檔案類： CHttpFile、CFtpFileFind、CInternetFile — 實際資料傳輸介面，繼承 CStdioFile 支援 ReadString/WriteString。

CInternetSession 建構關鍵參數

CInternetSession(LPCTSTR pstrAgent = NULL,      // User-Agent，NULL 使用預設
                 DWORD dwContext = 1,           // 非同步回呼識別碼
                 DWORD dwAccessType = INTERNET_OPEN_TYPE_PRECONFIG, // 連線類型
                 LPCTSTR pstrProxyName = NULL,  // Proxy 位址
                 LPCTSTR pstrProxyBypass = NULL,// Proxy 例外清單
                 DWORD dwFlags = 0);            // 旗標

• dwAccessType：PRECONFIG（用 IE 設定）、DIRECT（直連）、PROXY（指定 Proxy）。
• dwFlags：INTERNET_FLAG_DONT_CACHE（不快取）、INTERNET_FLAG_OFFLINE（離線模式）。

HTTP GET 簡易範例

CInternetSession session(_T("MyApp/1.0"));
CStdioFile* pFile = session.OpenURL(_T("https://example.com/api/data"),
    1, INTERNET_FLAG_TRANSFER_ASCII | INTERNET_FLAG_RELOAD);
CString strLine, strResponse;
while (pFile->ReadString(strLine)) strResponse += strLine + _T("\n");
pFile->Close();
delete pFile;
session.Close();
// 處理 strResponse...

HTTP POST 進階範例

CInternetSession session;
CHttpConnection* pConn = session.GetHttpConnection(_T("api.example.com"), INTERNET_DEFAULT_HTTP_PORT);
CHttpFile* pFile = pConn->OpenRequest(CHttpConnection::HTTP_VERB_POST,
    _T("/submit"), NULL, 1, NULL, NULL, INTERNET_FLAG_RELOAD);
pFile->AddRequestHeaders(_T("Content-Type: application/x-www-form-urlencoded"));
CString strPostData = _T("name=test&value=123");
pFile->SendRequest(NULL, 0, (LPVOID)(LPCTSTR)strPostData, strPostData.GetLength());

CString strResp;
while (pFile->ReadString(strLine)) strResp += strLine + _T("\n");
// 清理
pFile->Close(); delete pFile;
pConn->Close(); delete pConn;
session.Close();

常用旗標與技巧

非同步與回呼

• 建構時指定 dwContext，覆寫 OnStatusCallback 處理 INTERNET_STATUS_CONNECTING_TO_SERVER、INTERNET_STATUS_REQUEST_COMPLETE 等事件。
• 或使用 CAsyncMonikerFile 配合 IBindStatusCallback 實現更精細進度控制。

錯誤處理

所有網路操作拋出 CInternetException*，捕獲後呼叫 GetErrorMessage 取得描述，m_dwError 為 WinInet 錯誤碼（如 ERROR_INTERNET_TIMEOUT、ERROR_INTERNET_NAME_NOT_RESOLVED）。