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