DMessengerPrivateEvents::OnAlertReceived event
[OnAlertReceived is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Fires when an alert notification is sent from a Messenger service to a Messenger client application.
Syntax
void OnAlertReceived(
[in] BSTR bstrAlert,
[in, out] VARIANT_BOOL *pBoolfEnableDefault = VARIANT_TRUE
);
Parameters
-
bstrAlert [in]
-
BSTR containing the alert notification message.
-
pBoolfEnableDefault [in, out]
-
Pointer to a VARIANT_BOOL that defines one of the following possible values.
Value Meaning - VARIANT_FALSE
- false
Alerts are disabled. - VARIANT_TRUE
- true
Alerts are enabled.
Return value
This event does not return a value.
Remarks
A Messenger client receives this event if it has called the EnableAlertEvents method and one of the Messenger service sites that the application is connected to fires an alert.
The value of pBoolfEnableDefault indicates whether a popup window is displayed when this event is received. You must set this value to VARIANT_FALSE to specify that Windows Messenger must not display a popup window for this alert; otherwise a popup window is displayed.
Requirements
| Minimum supported client |
Windows 2000 Professional, Windows XP [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| End of client support |
Windows XP |
| End of server support |
Windows Server 2003 |
| Product |
Messenger 4.5 |
| Header |
|
| IDL |
|
| DLL |
|