IMessengerPrivate::EnableAlertEvents Method
Deprecated. Enables the Messenger client to be notified when the Messenger service fires events.
Syntax
HRESULT EnableAlertEvents( SAFEARRAY (LONG) *ppsaSiteIds );
Parameters
- ppsaSiteIds
[in, out] Pointer to an array of type LONG that specifies the site IDs from which the object will receive notification events.
Return Value
Returns one of the following values:
S_OK The method call was completed successfully. S_FALSE The method call failed because the service was locked. E_INVALIDARG The parameter passed to this method is not valid for this method call. E_OUTOFMEMORY The array ppsaSiteIds is too large.
Remarks
This method passes a pointer to an array of site IDs, which have a LONG integer type. When a Messenger client application has called this method, it receives alert notifications from Messenger service sites with the DMessengerPrivateEvents::OnAlertReceived event.
Note This method is not available for scripting languages.
Important IMessengerPrivate::EnableAlertEvents is no longer available in Windows Vista. See Windows Messenger for more information.
See Also
IMessengerPrivate::AddContact, DMessengerPrivateEvents::OnAlertReceived, Messenger Lock and Key API, Messenger Session Invite and Messenger Private APIs