RasCustomDialFn 回调函数 (ras.h)

项目
08/25/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
)
{...}

parameters

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	函数无法分配足够的内存来完成操作。

注解

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

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

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

要求


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