RasDial

rasdial命令三種使用方法，先列出如下，並在其後對其做相應解釋。

基本介紹

• 中文名：RasDial
• 作業系統：WindowsCE
• 版本：大於等於1.0
• 定義位置：Ras.h,Afdfunc.h

格式

一、rasdial命令格式：

（一）rasdial

該命令為查看RAS連線狀況，根據你是否連線到伺服器，提示分為：您已經連線到 寬頻連線名稱（用戶名），表示已經連線，並且告訴你連線的是哪個寬頻連線。（一台機子可以建立多個寬頻連線的，每個寬頻連線需要有各自的名稱，在WIN7中稱為用戶名。）或者為沒有連線，表明你沒有連線到伺服器上。

（二）rasdial [entryname] /DISCONNECT

該命令用戶斷開寬頻連線，如果只有一個寬頻連線名稱，則可以省略 [entryname]，即省略寬頻連線名稱， /DISCONNECT中的/不要忘記加。如果有多個寬頻連線，則必須寫上寬頻連線名稱。

（三）rasdial entryname [username[password|*]] [/DOMAIN:domain] [/PHONE:phonenumber] [/CALLBACK:callbacknumber] [/PHONEBOOK:phonebookfile] [/PREFIXSUFFIX]

其中[]括起來的表示可以省略，username為網路運營商（比如網通、電信）提供給你的用戶名，password為密碼，DOMAIN為連線到的域，PHONE為撥號連線的號碼，PHONEBOOK可以從指定的檔案中讀取電話號，進行撥號，除了名稱和密碼外，其他的一般不需要設定。

二、rasdial命令的使用：

可以通過在運行欄中輸入該命令運行，也可以先進入CMD或者COMMAND，然後再運行該命令，直接輸入，系統會自動調用CMD命令執行。

也可以通過批處理命令，以及高級語言，比如C、C++、JAVA調用該命令，以實現功能更為豐富的撥號任務。

比如實現自動撥號，可以寫 rasdial "寬頻連線名稱" 寬頻連線用戶名 寬頻連線密碼 這條語句，注意其中的寬頻連線名稱要加引號，是英文的雙引號，每一項中間隔一個空格。將其用記事本寫入，保存為擴展名為bat或者cmd的檔案。將其放入啟動項，則可以實現開機自動啟動，然後進行自動撥號。

“C:\Documents and Settings\Administrator\「開始」選單\程式\啟動”，該目錄一般為開機啟動項的存放目錄，也可以在開始欄里找到。

概述

本函式建立RAS 客戶端和伺服器端的一個連線。這個連線包括和返回用戶驗證信息。

函式原型：

DWORD RasDial(

LPRASDIALEXTENSIONS dialExtensions,

LPTSTR phoneBookPath ,

LPRASDIALPARAMS rasDialParam ,

DWORD NotifierType,

LPVOID notifier,

LPHRASCONN pRasConn );

參數

dialExtensions

本參數可以被忽略並且可以設定為NULL,在Windows CE,RasDial 總是使用RASDIALEXTENSIONS 當做默認選項。

phoneBookPath

本參數可以被忽略並且可以設定為NULL，通過電話簿存儲進行撥接註冊，而不是通過電話簿檔案。

rasDialParam

一個指向RASDIALPARAMS結構的指針，用來描述 RAS連線的調用參數。調用者必須設定RASDIALPARAMS結構的 dwSize成員(即結構大小)，用sizeof(RASDIALPARAMS)取得大小，防止不同版本的系統取得的大小不同

NotifierType

描述通告程式的參數性質。如果通告程式為NULL,本參數可以忽略，如果非空，則設定本參數為下面值：

0xFFFFFFFF 通過程式是一個句柄，是窗體接收通告程式訊息用的。在通告程式進行中，wParam參數指示 RAS連線將要進入的連線狀態。當發生錯誤時lParam里存儲錯誤信息。

通告程式處理時，使用的訊息是：WM_RASDIALEVENT。

notifier

一個指針，指向窗體句柄，用來接收RasDial的通告事件。如果本參數非空，RasDial為每一個通告事件傳送一個windows訊息。RasDial調用異步操作:在建立連線之前RasDial立即返回，使用窗體進行進程通信。

如果本參數被設定為：NULL,RasDial 調用同步操作：RasDial不立即返回，直到連線成功或者連線失敗。

如果本參數非空,在調用RasDial之後，窗體通知會在任何時候出現。當下列事件發生時通知結束：

連線被建立，換句話說，RAS的連線狀態是RASCS_Connected

連線失敗，換句話說，dwError 非零

RasHangUp在連線時被調用

在RasDial最初被調用時，在執行緒獲取上下文時產生回調通知

pRasConn

一個HRASCONN類型的指針，必須設定HRASCONN 類型變數為空在調用RasDial前。如果RasDial成功，本函式存儲一個RAS連線句柄在本參數中。

返回值：

0表示成功。而且本函式存儲一個RAS連線的句柄的指針在pRasConn中

非0值表示錯誤。錯誤的宏定義在RAS頭檔案中 例如：ERROR_NOT_ENOUGH_MEMORY記憶體不足，在Raserror.h中定義錯誤的宏定義

備註

RASDIALPARAMS結構的szCallBackNumber和szPhoneNumber成員 被參數 rasDialParam指向 如果不適用設定為NULL

RasDial 不會列出上網登入對話框，RasDial通過遠程網路套用使用。應用程式負責獲得用戶信息。

錯誤產生後，通過調用RasGetConnectStatus可以立即返回錯誤。 可用數據直到調用 RasHangUp函式才失效。在一個非空連線句柄被存儲到pRasConn時應用程式最終調用RasHangUp。 即使RasDial返回一個非零值，(即發生了錯誤)，仍然要調用RasHangUp。一個應用程式能夠安全的從RasDial產生的句柄調用RasHangUp。如果RasHangUp成功了，通常程式在返回時才結束。只有在支持PostMessage函式時，窗體基礎句柄要想工作。

必要條件：

作業系統: Windows CE

版本：大於等於1.0

定義位置：Ras.h, Afdfunc.h

預處理lib檔案 Ppp.lib

註：

本API是微軟公司提供的完整 Windows CE作業系統包的一部分。這個功能取決於原始設備製造商，有些設備可能不支持這個API。

相關參考

RasGetConnectStatus,RasHangUp,RASDIALPARAMS, WM_RASDIALEVENT

後衛大師製作版15:55 2009-9-3

使用rasdial命令製作的開機自動連線寬頻

新建記事本—輸入“rasdial寬頻連線‘你的寬頻連線賬號’ ‘你的寬頻連線密碼’”，另外儲存為*.bat（此BAT可以為任何名字，隨便起），然後找到“C:\Documents and Settings\Administrator\「開始」選單\程式\啟動”，即開始啟動資料夾，把此bat放在裡面即可實現開機自動撥號連線寬頻。