rasCustomDialFn 回呼函式 (ras.h)

發行項
03/15/2023

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

]

RasCustomDial函式是由協力廠商自訂撥號 DLL 匯出的應用程式定義函式。此函式可讓協力廠商廠商實作自訂遠端存取撥號常式。

語法

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

參數

hInstDll

已載入之自訂撥號 DLL 實例的控制碼。

lpRasDialExtensions

RASDIALEXTENSIONS結構的指標，指定要啟用的一組 RasDial擴充功能。如果不需要啟用擴充功能，請將此參數設定為 Null 。

lpszPhonebook

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

lpRasDialParams

RASDIALPARAMS結構的指標，指定 RAS 連線的呼叫參數。

呼叫端必須將 RASDIALPARAMS 結構的 dwSize 成員設定為 sizeof (RASDIALPARAMS) ，以識別所傳遞的結構版本。

dwNotifierType

此參數與RasDial函式的dwNotifierType參數相同。如需詳細資訊，請參閱 RasDial 參考頁面。

lpvNotifier

此參數與RasDial函式的lpvNotifier參數相同。如需詳細資訊，請參閱 RasDial 參考頁面。

lphRasConn

HRASCONN類型的變數指標。在呼叫RasDial之前，將HRASCONN變數設定為Null。如果 RasDial 成功，它會將 RAS 連線的控制碼儲存至 *lphRasConn。

dwFlags

此參數保留供日後使用。

傳回值

如果函式成功，傳回值會 ERROR_SUCCESS ，而且會傳回 lphRasConn 參數所指向之變數中 RAS 連接的控制碼。

如果函式失敗，則傳回值是下列其中一個錯誤碼，或來自路由和遠端存取錯誤碼或 Winerror.h 的值。

值	意義
ERROR_NOT_ENOUGH_MEMORY	函式無法配置足夠的記憶體來完成作業。

備註

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

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

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

需求


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