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) |