可重用的 MFC RAS 類：CRAS 封裝 Windows 遠程訪問服務

CRAS 類簡介

CRAS 是一個 MFC 類，它完整封裝了 Windows 的遠程訪問服務。這個類的最大優勢在於：只需透過區域網路即可連接到 Internet，且無需在本機安裝 RAS，因為 RAS 的 DLL 會在運行時動態加載。這對於需要撥號連網但不想安裝完整 RAS 組件的應用程式來說，是一個極佳的輕量級解決方案。

基本用法

使用 CRAS 非常直觀。只需將 CRAS 相關檔案加入專案，建立一個 CRAS 類實例，然後呼叫其 Initialize 方法即可完成初始化：

BOOL CRAS::Initialize()

該方法回傳布林值，表示初始化是否成功。若回傳 FALSE，通常是因為系統未安裝 RAS。

取得撥號項目

初始化完成後，可透過以下成員函式取得 Windows 通訊錄中的撥號項目，並儲存在私有成員變數中供後續使用：

BOOL CRAS::GetEntryCount();
CString CRAS::GetEntry(ULONG ulIndex);

這兩個函式相當實用，例如可用來填充下拉式方塊或列表方塊，讓使用者選擇欲撥號的項目。

撥號與掛斷

若需執行撥號或掛斷操作，可呼叫以下函式：

BOOL CRAS::Dial(CString sEntry, CString sUserName, CString sPassword, CRASCallback pfnCallback, CString sDomain);
BOOL CRAS::HangUp();

• sEntry：撥號的通訊錄項目名稱
• sUserName、sPassword：登入網路的帳號與密碼
• sDomain：撥號至 Windows NT RAS 伺服器時必須提供的網域參數
• CRASCallback：回呼函式指標，當 RAS 事件（多為狀態變更）發生時會被呼叫；若不需要可傳 NULL

總結

CRAS 類為 MFC 應用程式提供了簡潔、強大的 RAS 封裝，動態載入 DLL 的設計使其部署極為方便，是開發撥號連網功能的理想選擇。