DMessengerPrivateEvents::OnAlertReceived event

Article
05/31/2018

[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	Msgrpriv.h
IDL	Msgrpriv.idl
DLL	Msnmsgrexe.adeb440d_7847_4f65_80bd_899870ed2ec9

Share via