RasCustomEntryDlgFn 回呼函式 (rasdlg.h)
RasCustomEntryDlg 函式是由第三方自定義撥號 DLL 導出的應用程式定義函式。 此函式可讓第三方廠商實作自定義對話框來管理電話簿專案。
語法
RasCustomEntryDlgFn Rascustomentrydlgfn;
BOOL Rascustomentrydlgfn(
HINSTANCE hInstDll,
LPWSTR lpszPhonebook,
LPWSTR lpszEntry,
LPRASENTRYDLG lpInfo,
DWORD dwFlags
)
{...}
參數
hInstDll
處理已載入之自定義撥號 DLL 的實例。
lpszPhonebook
Null 終止字串的指標，指定電話簿 (PBK) 檔案的完整路徑和檔名。 如果此參數為 NULL，函式會使用目前的默認電話簿檔案。 默認電話簿檔案是由 [撥號網络] 對話方塊的 [ 用戶喜好設定 ] 屬性表中的使用者所選取的 檔案 。
lpszEntry
Null 終止字串的指標，其中包含要編輯、複製或建立之電話簿項目的名稱。
如果您要編輯或複製專案，此參數是現有電話簿項目的名稱。 如果您要複製專案，請在RASENTRYDLG結構的 dwFlags 成員中設定RASEDFLAG_CloneEntry旗標。
如果您要建立專案，此參數是使用者可以變更的預設新項目名稱。 如果此參數為 NULL，函式會提供預設名稱。 如果您要建立專案，請在RASENTRYDLG結構的 dwFlags 成員中設定RASEDFLAG_NewEntry旗標。
lpInfo
RASENTRYDLG 結構的指標，其中包含其他輸入和輸出參數。 在輸入時，這個結構的 dwSize 成員必須指定 sizeof ( RASENTRYDLG) 。 使用 dwSize 成員來指出建立、編輯或複製專案。 如果發生錯誤， dwError 成員會傳回錯誤碼;否則，它會傳回零。
dwFlags
保留供未來使用。
傳回值
如果使用者建立、複製或編輯電話簿專案，則傳回值應該是 TRUE。 否則，函式應該會傳回 FALSE。
如果發生錯誤，RasCustomEntryDlg 應該將RASENTRYDLG結構的 dwError 成員設定為路由和遠端訪問錯誤碼或 Winerror.h 的值。
備註
如果所撥號專案之RASENTRY結構的 szCustomDialDll 成員指定自定義撥號 DLL，RASSS 會從 RasEntryDlg 呼叫此進入點。
如果自定義撥號 DLL 不支援此進入點，RAS 會將ERROR_NO_CUSTOMENTRYDLG傳回 給 RasEntryDlg 的呼叫端。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | rasdlg.h |