RasCustomDial

最新推荐文章于 2018-11-15 15:27:08 发布

cozil

最新推荐文章于 2018-11-15 15:27:08 发布

阅读量289

点赞数

分类专栏： RAS 文章标签： RAS

RAS 专栏收录该内容

62 篇文章 0 订阅

订阅专栏

DWORD WINAPI RasCustomDial(
   HINSTANCE           hInstDll,
   LPRASDIALEXTENSIONS lpRasDialExtensions,
   LPCWSTR             lpszPhonebook,
   LPRASDIALPARAMS     lpRasDialParams,
   DWORD               dwNotifierType,
   LPVOID              lpvNotifier,
   LPHRASCONN          lphRasConn,
   DWORD               dwFlags
);

说明

[该函数在Windows Server 2008版本中无法使用]
该函数是应用程序定义的由第三方定制拨号DLL导出的函数。该函数允许第三方提供商实现定制的远程访问拨号程序。

参数

hInstDll

指向定制拨号DLL的实例。

lpRasDialExtensions

指向一个RASDIALEXTENSIONS结构，用于设置一系列扩展属性。该参数可以为NULL。

lpszPhonebook

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

lpRasDialParams

指向一个RASDIALPARAMS结构，该结构包含建立RAS连接所需参数。调用者必须设置结构中的dwSize成员值为sizeof(RASDIALPARAMS)，确保能正确识别结构版本。

dwNotifierType

该参数与调用RasDial函数传递的dwNotifierType参数完全相同，查看RasDial函数说明。

lpvNotifier

该参数与调用RasDial函数传递的lpvNotifier参数完全相同，查看RasDial函数说明。

lphRasConn

指向一个HRASCONN类型的变量，调用RasDial函数之前将其值设置为NULL。若RasDial函数返回成功，则此变量包含建立的RAS连接句柄。

dwFlags

此参数保留未用。

返回值

该函数成功时返回ERROR_SUCCESS，并且通过参数lphRasConn 返回连接句柄。失败时返回下列错误码之一，或者来自Routing and Remote Access Error Codes 和 winerror.h中定义的值。

值	含义
ERROR_NOT_ENOUGH_MEMORY	内存不足无法完成操作

注意事项

如果拨号入口entry指向的RASENTRY结构中的szCustomDialDll成员指定了定制拨号DLL，则RasDial函数会调用本函数。
如果该函数调用了RasDial函数，则lpRasDialExtensions 不能为空。其dwFlags 成员值必须包含RDEOPT_CustomDial 标志位。
如果定制拨号DLL不支持此入口，RAS将返回给调用者ERROR_CANNOT_DO_CUSTOMDIAL 错误值。

系统支持

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