Share via


IRTCPortManager3::UpdateRemoteAddressEx2 (Windows Embedded CE 6.0)

1/6/2010

The UpdateRemoteAddressEx2 method informs the application that the remote address has been updated. The UpdateRemoteAddressEx2 method specifies the transport protocol that Port Manager is to use, in addition to the parameters specified by IRTCPortManager2::UpdateRemoteAddressEx.

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 UpdateRemoteAddressEx2(
  BSTR bstrRemoteAddress,
  long lRemotePort,
  long lTransport,
  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.

lTransport

[in] TCP or UDP. The transport protocol that Port Manager is to use.

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. This is up to the application that implements the methods.

Requirements

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

See Also

Reference

IRTCPortManager3
IRTCSessionPortManagement
IRTCPortManager

Concepts

IRTCPortManager2