RasCustomEntryDlgFn 回调函数 (rasdlg.h)

项目
03/01/2024

RasCustomEntryDlg 函数是由第三方自定义拨号 DLL 导出的应用程序定义的函数。此功能允许第三方供应商实现用于管理电话簿条目的自定义对话。

语法

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

参数

hInstDll

已加载的自定义拨号 DLL 实例的句柄。

lpszPhonebook

指向 以 null 结尾的字符串的指针，该字符串指定电话簿 (PBK) 文件的完整路径和文件名。如果此参数为 NULL，则该函数使用当前默认电话簿文件。默认电话簿文件是用户在“拨号网络”对话框的“用户首选项”属性表中选择的电话簿文件。

lpszEntry

指向 以 null 结尾的字符串的指针，该字符串包含要编辑、复制或创建的电话簿条目的名称。

如果要编辑或复制条目，此参数是现有电话簿条目的名称。如果要复制条目，请在 RASENTRYDLG 结构的 dwFlags 成员中设置RASEDFLAG_CloneEntry标志。

如果要创建条目，此参数是用户可以更改的默认新条目名称。如果此参数为 NULL，则该函数将提供默认名称。如果要创建条目，请在 RASENTRYDLG 结构的 dwFlags 成员中设置RASEDFLAG_NewEntry标志。

lpInfo

指向包含其他输入和输出参数的 RASENTRYDLG 结构的指针。输入时，此结构的 dwSize 成员必须指定 size of ( RASENTRYDLG) 。使用 dwSize 成员指示是创建、编辑还是复制条目。如果发生错误， dwError 成员将返回错误代码;否则，它将返回零。

dwFlags

保留供将来使用。

返回值

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

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

注解

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

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

要求

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