RasCustomDialDlgFn 回调函数 (rasdlg.h)

项目
03/01/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

一组指定 RasCustomDialDialDlg 选项的 位标志。

值	含义
RCD_Logon	如果此标志设置为 1，则表示从 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 成员必须指定 size of ( RASDIALDLG) 。如果发生错误， dwError 成员将返回错误代码;否则，它将返回零。

pvInfo

保留以供内部使用。此参数将始终为 NULL。

返回值

如果用户创建、复制或编辑电话簿条目，则返回值应为 TRUE。否则，函数应返回 FALSE。

如果发生错误，RasCustomEntryDlg 应将 RASENTRYDLG 结构的 dwError 成员设置为路由和远程访问错误代码或 Winerror.h 中的值。

注解

如果正在拨号的条目的 RASENTRY 结构的 szCustomDialDll 成员指定自定义拨号 DLL，则 RAS 从 RasDialDlg 调用此入口点。

如果此入口点调用 RasDial，则 lpRasDialExtensions 参数不得为 NULL，并且 RASDIALEXTENSIONS 结构的 dwfOptions 成员必须设置RDEOPT_CustomDial标志。

自定义拨号对话框必须支持 LOWORD (wParam) 等于 IDCANCEL 的WM_COMMAND消息。

如果自定义拨号 DLL 不支持此入口点，RAS 会将 ERROR_CANNOT_DO_CUSTOMDIAL 返回给 RasDialDlg 的调用方。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	rasdlg.h