RasCustomEntryDlgFn 回呼函式 (rasdlg.h)

發行項
03/01/2024

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