IMsgrSession::RemoteAddress Property

  • Article

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

Syntax

HRESULT IMsgrSession::get_RemoteAddress(BSTR *pbstrRemoteAddress);

Parameters

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

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The get_RemoteAddress should be called after IMsgrSession::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.

Important  IMsgrSession::RemoteAddress is no longer available in Windows Vista. See Windows Messenger for more information.

See Also

Messenger Session Invite and Messenger Private APIs, Messenger Lock and Key API