RasCustomEntryDlg

BOOL WINAPI RasCustomEntryDlg(
   HINSTANCE     hInstDll,
   LPWSTR        lpszPhonebook,
   LPWSTR        lpszEntry,
   LPRASENTRYDLG lpInfo,
   DWORD         dwFlags
);

说明

该函数是应用程序定义的由第三方定制拨号DLL导出的函数。该函数允许第三方提供商实现定制的对话框管理电话簿条目。

参数

hInstDll

指向定制拨号DLL的实例。

lpszPhonebook

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

lpszEntry

指向一个包含要拨号的电话簿条目。
如果是编辑或复制条目，该参数为电话簿中已存在的条目名称。当复制条目时，lpInfo参数指向的RASENTRYDLG结构中dwFlags成员必须设置RASEDFLAG_CloneEntry标志位。

如果是创建新条目，该名称为新条目名称。该参数为空时，自动使用一个默认的名称。创建新条目时，lpInfo参数指向的RASENTRYDLG结构中dwFlags成员必须设置RASEDFLAG_NewEntry标志位。

lpInfo

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

dwFlags

保留未用。

返回值

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

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

注意事项

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

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

系统支持

客户端最小支持	Windows 2000专业版
服务端最小支持	Windows 2000 Server
Header	Rasdlg.h