RasCustomDialDlg

BOOL WINAPI RasCustomDialDlg(
   HINSTANCE    hInstDll,
   DWORD        dwFlags,
   LPWSTR       lpszPhonebook,
   LPWSTR       lpszEntry,
   LPWSTR       lpszPhoneNumber,
   LPRASDIALDLG lpInfo,
   PVOID        pvInfo
);

说明

[该函数在Windows Server 2008版本不可用]
函数是应用程序定义的由第三方定制拨号DLL导出的函数。该函数允许第三方提供商实现定制的RAS连接对话框。

参数

hInstDll

向定制拨号DLL的实例。

dwFlags

该函数的选项标识集。 

值	含义
RCD_Logon	如果该标识被设置，则根据Windows当前登录的上下文选择合适的用户参数进行拨号。如果RasDial函数被调用，那么参数lpRasDialExtension指向的结构中dwfOptions成员必须包含RDEOPT_NoUser标识，用以指示从Windows当前登录的上下文进行拨号。

Windows Server 2003 and Windows XP/2000：该参数保留不用。

lpszPhonebook

指向一个包含完整路径的电话簿文件(PBK)。如果参数为空，则该函数使用默认的电话簿文件。默认的电话簿文件由用户在拨号网络对话框的[user preferences]属性窗口中选择。

lpszEntry

指向一个包含要拨号的电话簿条目。

lpszPhoneNumber

电话号码字符串。该参数为空时使用lpszEntry中的号码。

lpInfo

指向一个包含附加输入输出参数的RASDIALDLG结构。作为输入参数，结构成员dwSize必须设置为sizeof(RASDIALDLG)。当有错误发生时，结构成员dwError返回错误码，否则返回0。

pvInfo

保留参数。必须为NULL。

返回值

如果用户创建、修改或者复制了电话簿，应返回TRUE，否则返回FALSE。

当有错误发生时，RasCustomEntryDlg函数应设置RASENTRYDLG结构中的dwError成员为来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。

注意事项

当电话簿条目entry（RASENTRY)中的成员szCustomDialDll设置了定制的拨号DLL时，RAS将通过RasDialDlg函数调用此函数。

如果该函数调用了RasDial函数，那么lpRasDialExtensions参数必须为NULL，并且RASDIALEXTENSIONS结构的成员dwfOptions必须设置RDEOPT_CustomDial标志位。

定制的拨号对话框必须接收WM_COMMAND消息，LOWORD(wParam)值始终为IDCANCEL。

如果定制的拨号DLL不支持此入口，那么RAS将返回错误消息ERROR_CANNOT_DO_CUSTOMDIAL给调用者RasDialDlg。

系统支持

客户端最小支持	Windows 2000专业版
服务端最小支持	Windows 2000 Server
服务端最大支持	Windows Server 2003
Header	Ras.h
Unicode和ANSI名称	RasCustomDialDlgW (Unicode) 和RasCustomDialDlgA (ANSI)