RasGetEntryDialParams

RasGetEn lpRasDialParams lpRasDialParams

RasGetEntryDialParams
通過對RasDial的成功調用,本函式調用後返回連線信息被保存為電話簿入口。
函式原型:
DWORD RasGetEntryDialParams(
LPWSTR lpszPhoneBook,
LPRASDIALPARAMS lpRasDialParams,
LPBOOL lpfPassword );
參數:
lpszPhoneBook
Windows CE:本參數被忽視,或者設定為NULL,通過電話簿存儲進行撥接註冊,而不是通過電話簿檔案。
lpRasDialParams
一個指向RASDIALPARAMS結構的指針,在輸入時,dwSize成員必須被 RASDIALPARAMS結構指定大小。並且szEntryName 成員必須被指定一個有效地電話簿入口,輸出時結構接收一個已經被指定電話簿入口相關聯的連線參數。
注意:szPhoneNumber 成員不能接到與電話簿入口相關聯的電話號碼,要想獲得的電話號碼需要調用 RasGetEntryProperties 函式
pfPassword
一個BOOL類型指針,表示函式是否能通過電話簿入口返回和用戶名相關聯的密碼,函式設定該標誌位為TRUE時,用戶的密碼返回到lpRasDialParams 參數指向的RASDIALPARAMS 結構的szPassword 成員中
返回值:
0表示成功。ERROR_BUFFER_INVALID 表示lpRasDialParams 或者 lpfPassword 指針是無效的。或者lpRasDialParams 得緩衝區是無效的。ERROR_CANNOT_OPEN_PHONEBOOK 表示電話簿被損壞或者丟失組件。ERROR_CANNOT_FIND_PHONEBOOK_ENTRY 表示電話簿的入口不存在。
RAS錯誤的宏,定義在Raserror.h頭檔案中,包含Raserror.h頭檔案取得錯誤定義。
Windows CE 備註:
lpRasDialParams 的szCallBackNumber 和 szPhoneNumber 成員如果不使用,設定為NULL。
當參數 lpRasDialParams指向的RASDIALPARAMS 結構的dwSize 成員時,lpRasDialParams 已經被初始化了,或者被設定了錯誤的值。如果RasGetEntryDialParams 函式失敗,則返回一個有誤導性的錯誤值 ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
注意本函式需要一個純文本密碼,但是本函式不能返回一個純文本密碼。因此只能可信應用程式才能夠被用來調用RasGetEntryDialParams。
另外應該執行安全設備,並且鼓勵用戶使用一個強力密碼。防止用戶從設備上搜尋密碼
必備條件
作業系統 Windows CE
版本 大於等於1.0
定義位置:Ras.h, Afdfunc.h
預處理lib檔案Ppp.lib
註:
本API是微軟公司提供的完整 Windows CE作業系統包的一部分。這個功能取決於原始設備製造商,有些設備可能不支持這個API。
相關參考:
RasDial, RASDIALPARAMS, RasSetEntryDialParams
後衛大師製作版17:22 2009-9-3

相關詞條

相關搜尋

熱門詞條

聯絡我們