IMsgrSession::RemoteAddress Property

[RemoteAddress is no longer available in 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 (get)

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

Parameters

pbstrRemoteAddress [out]

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

Return Value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The get_RemoteAddress should be called after State becomes SS_CONNECTED.

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

Error CodeMeaning
E_INVALIDARGThe parameter passed to the property was not valid.
E_OUTOFMEMORYThe IP address is too long.
S_FALSEThe IP address was not retrieved.

 

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

Error CodeMeaning
0x8007000EThe IP address is too long.
0x80070057One of the possible values is not valid.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

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

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010

Show: