DMsgrObjectEvents::OnTextReceived event

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

Indicates that a message has been received.


The OnTextReceived event is available for use in Windows Messenger 4.7. It might be altered or unavailable in subsequent versions of Windows Messenger.


void OnTextReceived(
  [in]      IMsgrIMSession *pIMSession,
  [in]      IMsgrUser      *pSourceUser,
  [in]      BSTR           bstrMsgHeader,
  [in]      BSTR           bstrMsgText,
  [in, out] VARIANT_BOOL   *pfEnableDefault


pIMSession [in]

Pointer to an IMsgrIMSession interface.

pSourceUser [in]

Pointer to an IMsgrUser interface.

bstrMsgHeader [in]

BSTR that contains the header text.

bstrMsgText [in]

BSTR that contains the message text.

pfEnableDefault [in, out]

Pointer to a VARIANT_BOOL that indicates whether the default is enabled.

Return value

This event does not return a value.


End of client support
Windows XP
End of server support
Windows Server 2003