void WINAPI RasPBDlgFunc(
_In_ DWORD dwCallbackId,
_In_ DWORD dwEvent,
_In_ LPTSTR pszText,
_In_ LPVOID pData
);
说明
该函数是一个应用程序定义的回调函数,用于在RasPhonebookDlg函数显示对话框时接收用户活动通知消息。
参数
dwCallbackId [in]
指定一个应用程序定义的值,该值应与调用RasPhonebookDlg函数时传递的RASPBDLG结构中的dwCallback成员值相同。
dwEvent [in]
指定哪些事件发生时触发回调,事件标记在以下列表中描述。
值 | 含义 |
---|---|
RASPBDEVENT_AddEntry | 接收用户创建新的电话簿条目或复制一个已存在条目通知。pszText参数代表相关的条目名称。pData参数未使用。 |
RASPBDEVENT_EditEntry | 接收用户修改一个已存在的电话簿条目通知。pszText参数代表相关的条目名称。pData参数未使用。 |
RASPBDEVENT_RemoveEntry | 接收用户删除电话簿条目通知。pszText参数代表相关的条目名称。pData参数未使用。 |
RASPBDEVENT_DialEntry | 接收用户成功拨号通知。pszText参数代表相关的条目名称。pData参数未使用。 |
RASPBDEVENT_EditGlobals | 接收用户在[用户偏好设置]属性页修改内容通知。pszText参数代表用户选择的包含完整路径的默认电话簿文件。pData参数未使用。即使在调用RasPhonebookDlg函数时传递了NULL值的电话簿文件字符串,拨号成功仍会收到通知。此时pszText参数代表默认的电话簿文件。 |
RASPBDEVENT_NoUser | 当初始化RasPhonebookDlg函数对话框时指定了RASPBDFLAG_NoUser标记会收到通知。pData参数指向一个RASNOUSER结构。回调函数应在此时设置用户登录凭证和对话框超时时间。回调函数返回后RasPhonebookDlg函数使用输入的登录凭证提交给远程服务器验证。pszText参数未使用。 |
RASPBDEVENT_NoUserEdit | 在RASPBDEVENT_NoUser事件通知发生期间如果修改了用户登录凭证则会收到此通知。pData参数指向一个RASNOUSER结构,该结构包含已更新的凭证数据。执行拨号操作期间,如果用户修改了密码,或者认证失败重试时更改了凭证,都会触发该事件通知。pszText参数未使用。 |
pszText [in]
指向一个字符串,具体含义由dwEvent参数决定。
pData [in]
指向一个缓冲,具体含义由dwEvent参数决定。
返回值
该函数无返回值。
系统支持
客户端最小支持 | Windows 2000 专业版 |
---|---|
服务端最小支持 | Windows 2000 Server |
Header | Rasdlg.h |
Unicode和ANSI名称 | RasPBDlgFuncW(Unicode)和RasPBDlgFuncA(ANSI) |