IRTCPortManager3::UpdateRemoteAddressEx2
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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
IRTCSessionPortManagement
IRTCPortManager
IRTCPortManager3