DWORD dwCallbackId,

// an application-defined value

    DWORD dwEvent,

// indicates the event that occurred

    LPTSTR pszText,

// pointer to an additional string argument

    LPVOID pData

// pointer to an additional buffer argument

   );

Value

Meaning

RASPBDEVENT_AddEntry

Received when the user creates a new phone-book entry or copies an existing phone-book entry. The pszText parameter is the name of the new or copied entry. The pData parameter is undefined.

RASPBDEVENT_EditEntry

Received when the user changes an existing phone-book entry. The pszText parameter is the name of the modified entry. The pData parameter is undefined.

RASPBDEVENT_RemoveEntry

Received when the user deletes a phone-book entry. The pszText parameter is the name of the deleted entry. The pData parameter is undefined.

RASPBDEVENT_DialEntry

Received when the user successfully dials an entry. The pszText parameter is the name of the newly connected entry. The pData parameter is undefined.

RASPBDEVENT_EditGlobals

Received when the user makes changes in the User Preferences property sheet. The pszText parameter is the full path of the default phone-book file selected by the user. The pData parameter is undefined.

This event is also received during dialog startup if the lpszPhonebook parameter of the RasPhonebookDlg5JVD_GZ call is NULL. In this case, the event informs the caller of the path of the default phone book.

RASPBDEVENT_NoUser

Received during dialog box initialization when the RASPBDFLAG_NoUser flag is set. The pData parameter is a pointer to a RASNOUSERKT.S74 structure. The callback function should fill the structure with the user s logon credentials and dialog timeout. The RasPhonebookDlg function then uses the supplied credentials for authentication by the remote server. The pszText parameter is undefined.

RASPBDEVENT_NoUserEdit

Received if the RASPBDFLAG_NoUser flag is set and the user changes the credentials that you supplied during the RASPBDEVENT_NoUser event. The pData parameter is a pointer to a RASNOUSER structure containing the updated credentials. This occurs during a dialing operation if the user changes his or her password, or if the authentication fails and the user retries authentication with different credentials. The pszText parameter is undefined.