[New - Windows NT]
RasPBDlgFunc功能是一个应用程序定义的回调函数,在RasPhonebookDlg对话框打开时接收用户活动的通知。
VOID WINAPI RasPBDlgFunc(
DWORD 【dwCallbackId】, | //应用程序定义的值 |
DWORD 【// indicates the event that occurred】, | //表示发生的事件 |
LPTSTR 【pszText】, | //指向一个额外的字符串参数 |
LPVOID 【的pData】 | //指向一个额外的缓冲区参数 |
); |
参数
【dwCallbackId】
表示传递给RasPhonebookDlg功能的RASPBDLG结构RASPBDLG结构中指定的应用程序定义值。
【// indicates the event that occurred】
一组位标志,表示发生的事件。此参数是以下值之一。
值 | 含义 |
RASPBDEVENT_AddEntry | 当用户创建新的电话簿条目或复制现有的电话簿条目时收到。【pszText】参数是新的或复制的条目的名称。【的pData】参数未定义。 |
RASPBDEVENT_EditEntry | 当用户更改现有的电话簿条目时收到。【pszText】参数是修改的条目的名称。【的pData】参数未定义。 |
RASPBDEVENT_RemoveEntry | 当用户删除电话簿条目时收到。【pszText】参数是已删除条目的名称。【的pData】参数未定义。 |
RASPBDEVENT_DialEntry | 当用户成功拨号时收到。【pszText】参数是新连接的条目的名称。【的pData】参数未定义。 |
RASPBDEVENT_EditGlobals | 当用户在用户首选项属性表中进行更改时收到。【pszText】参数是用户选择的默认电话簿文件的完整路径。【的pData】参数未定义。 如果RasPhonebookDlg调用的【lpszPhonebook】参数为NULL,则在对话启动期间也会收到此事件。在这种情况下,事件通知呼叫者默认电话簿的路径。 |
RASPBDEVENT_NoUser | 设置RASPBDFLAG_NoUser标志时,在对话框初始化期间接收到。【的pData】参数是指向RASNOUSER结构的指针。回调函数应该使用用户的登录凭据和对话框超时填充结构。然后,RasPhonebookDlg函数使用提供的凭据进行远程服务器的身份验证。【pszText】参数未定义。 |
RASPBDEVENT_NoUserEdit | 如果设置了RASPBDFLAG_NoUser标志并且用户更改了在RASPBDEVENT_NoUser事件期间提供的凭据,则接收。【的pData】参数是指向包含更新的凭据的RASNOUSER结构的指针。如果用户更改他或她的密码,或者如果认证失败,并且用户使用不同的凭证重试认证,则在拨号操作期间发生这种情况。【pszText】参数未定义。 |
【pszText】
指向一个额外的字符串参数,其含义取决于【// indicates the event that occurred】参数中指示的事件。
【的pData】
指向一个额外的缓冲区参数,其含义取决于【// indicates the event that occurred】参数中指示的事件。
也可以看看