IRTCPortManager2::UpdateRemoteAddressEx

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

The UpdateRemoteAddressEx method informs the application that the remote address has been updated. The UpdateRemoteAddressEx method specifies the remote port in addition to the parameters specified by IRTCPortManager::UpdateRemoteAddress.

Some NATs associate each port mapping with a particular remote address and will reject traffic from remote addresses other than the associated one. This method allows the application to update the remote address associated with a particular mapping on the NAT.

Syntax

HRESULT UpdateRemoteAddressEx(
  BSTR bstrRemoteAddress,
  long lRemotePort,
  BSTR bstrInternalLocalAddress,
  long lInternalLocalPort,
  BSTR bstrExternalLocalAddress,
  long lExternalLocalPort
);

Parameters

Parameter	Description
bstrRemoteAddress	[in] Contains the IP address of the remote endpoint for which the NAT mapping might be associated. Currently this parameter will contain an IPv4 dotted address. However, in the future an IPv6 address may also be entered in this parameter. The application must not, therefore, assume this will be an IPv4 address.
lRemotePort	[in] Contains the remote port.
bstrInternalLocalAddress	[in] Contains the client's internal IP address.
lInternalLocalPort	[in] Contains the client's internal port.
bstrExternalLocalAddress	[in] Contains the NAT's external IP address.
lExternalLocalPort	[in] Contains the NAT's external port.

Return Value

RTC methods may return any of the standard COM and ADSI return values.

Requirements

Header	rtccore.h, rtccore.idl
Library	rtcdll.dll
Windows Embedded CE	Windows Embedded CE 6.0 and later

See Also

Reference

IRTCSessionPortManagement
IRTCPortManager

Concepts

IRTCPortManager2