RasCustomEntryDlgFn 回调函数 (rasdlg.h)
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 |