IMsgrSession::RemoteAddress property

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

Retrieves a value that indicates the Internet Protocol (IP) address of the other party in the session.

This property is read-only.

Syntax

HRESULT get_RemoteAddress(
  [out, retval] BSTR *pbstrRemoteAddress
);

Property value

Pointer to a BSTR that indicates the IP address of the other session participant.

Remarks

The get_RemoteAddress should be called after State becomes SS_CONNECTED.

The following table lists the error codes returned by this property.

Error Code Meaning
E_INVALIDARG The parameter passed to the property was not valid.
E_OUTOFMEMORY The IP address is too long.
S_FALSE The IP address was not retrieved.

The following table lists the error codes returned by this property.

Error Code Meaning
0x8007000E The IP address is too long.
0x80070057 One of the possible values is not valid.

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.0
Header
Msgrpriv.h
IDL
Msgrpriv.idl
DLL
Msgsc.dll

See also

IMsgrSession

Messenger Session Invite and Messenger Private APIs

Messenger Lock and Key API