IMessengerConversationWnd::History property

Article
05/31/2018

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

Returns the text from the history of the conversation window.

This property is read-only.

Syntax

HRESULT get_History(
  [out, retval] BSTR *bstrHistoryText
);

Property value

Pointer to a BSTR that contains the text of the conversation window.

Error codes

Returns one of the following values.

Name	Meaning
S_OK	Success.
E_FAIL	Client was not signed in to the primary service at the time this method was called; or, the conversation window is closed.
S_FALSE	Could not bring focus to the window.
RPC_X_NULL_REF_POINTER	bstrHistoryText is a NULL pointer.

Remarks

The following table lists error codes returned by this method.

Error Code	Meaning
0x80004005	Client was not signed in to the primary service at the time this method was called; or, the conversation window is closed.

The History property not scriptable.

Note

This property is not available for scripting languages.

Examples

The following Visual Basic example shows the use of this method.

Public WithEvents MsgrUIA As MessengerAPI.Messenger 
Public mWindow2 As MessengerAPI.IMessengerConversationWnd 

Private Sub btnWindow2History_Click() 
    On Error Resume Next 
    Dim strContactName_0 as String 
    'Launch a Conversation window with an online contact 
    '(where strContactName_0 is the online contact's signinname) 
    Set mWindow2 = MsgrUIA.InstantMessage (strContactName_0) 
    MsgBox mWindow2.History 
    ErrorTrap ("IMessengerConversationWnd.History") 'Error handling routine 
End Sub

Requirements


End of client support	Windows XP
End of server support	Windows Server 2003
Header	Msgrua.h
IDL	Msgrua.idl
DLL	Msgsc.dll