DMessengerPrivateEvents::OnContactListAdd event

[OnContactListAdd is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Notifies a Messenger client that a contact has been added to the contact list.

Syntax

HRESULT OnContactListAdd(
  [in] long      hr,
  [in] IDispatch *pMContact
);

Parameters

hr [in]

LONG that defines the error code for the operation.

pMContact [in]

Pointer to an IDispatch interface of a MessengerContact object representing the user that has been added to the contact list.

Return value

If this event succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The same DISPID is defined on DMessengerEvents, and so the event also occurs on the Messenger object.

Requirements

Minimum supported client
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

See also

DMessengerPrivateEvents

OnAlertReceived

OnLockChallenge

OnLockEnable

RequestChallenge

SendResponse

Messenger Lock and Key API

Messenger Session Invite and Messenger Private APIs