RasCustomDialDlgFn 回呼函式 (rasdlg.h)

發行項
03/05/2024

[自 Windows Server 2008 起，此函式無法使用。

]

RasCustomDialDlg 函式是由第三方自定義撥號 DLL 導出的應用程式定義函式。此函式可讓第三方廠商實作自定義 RAS 連線對話方塊。

語法

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

參數

hInstDll

已載入之自定義撥號 DLL 實例的句柄。

dwFlags

指定 RasCustomDialDlg 選項的一組位旗標。

值	意義
RCD_Logon	如果此旗標設定為一個，則會從 Windows 登入內容撥號連線。 RasDial 會使用這項資訊來取得連線項目的適當使用者喜好設定。如果從這個進入點呼叫 RasDial，lpRasDialExtension 參數的 dwfOptions 成員必須設定RDEOPT_NoUser旗標，以指出從 Windows 登入內容撥號連線。

Windows Server 2003 和 Windows XP/2000： 此參數是保留的，不應使用。

lpszPhonebook

Null 終止字串的指標，指定電話簿 (PBK) 檔案的完整路徑和檔名。如果此參數為 NULL，函式會使用目前的默認電話簿檔案。默認電話簿檔案是由使用者選取的 [撥號網络] 對話方塊之 [用戶喜好設定] 屬性表中的使用者所選取的檔案。

lpszEntry

Null 終止字串的指標，其中包含要撥號的電話簿項目名稱。

lpszPhoneNumber

Null 終止字串的指標，其中包含會覆寫電話簿專案中所儲存號碼的電話號碼。如果此參數為 NULL，RasDialDlg 會使用電話簿專案中的數位。

lpInfo

RASDIALDLG 結構的指標，其中包含其他輸入和輸出參數。在輸入時，這個結構的 dwSize 成員必須指定 sizeof ( RASDIALDLG) 。如果發生錯誤， dwError 成員會傳回錯誤碼;否則會傳回零。

pvInfo

保留供內部使用。此參數一律為 NULL。

傳回值

如果使用者建立、複製或編輯電話簿專案，則傳回值應該是 TRUE。否則，函式應該會傳回 FALSE。

如果發生錯誤，RasCustomEntryDlg 應該將RASENTRYDLG結構的 dwError 成員設定為路由和遠端訪問錯誤碼或 Winerror.h 的值。

備註

如果所撥號專案的 szCustomDialDll 成員指定自定義撥號 DLL，RASENTRY 結構的 SzCustomDialDll 成員會從 RasDialDlg 呼叫此進入點。

如果此進入點呼叫 RasDial，則 lpRasDialExtensions 參數不得為 NULL，而且 RASDIALEXTENSIONS 結構的 dwfOptions 成員必須設定RDEOPT_CustomDial旗標。

自定義撥號對話框必須支援 WM_COMMAND 訊息，其中 LOWORD (wParam) 等於 IDCANCEL。

如果自定義撥號 DLL 不支援此進入點，RAS 會將 ERROR_CANNOT_DO_CUSTOMDIAL 傳回給 RasDialDlg 的呼叫端。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	rasdlg.h