IRTCPortManager::UpdateRemoteAddress
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
This method informs the application that the remote address has been updated. 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 UpdateRemoteAddress(
BSTR bstrRemoteAddress,
BSTR bstrInternalLocalAddress,
long lInternalLocalPort,
BSTR bstrExternalLocalAddress,
long lExternalLocalPort
);
Parameters
- bstrRemoteAddress
[in] 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 assume this will be an IPv4 address.
- bstrInternalLocalAddress
[in] The client's internal IP address.
- lInternalLocalPort
[in] The client's internal port.
- bstrExternalLocalAddress
[in] The external IP address of the NAT.
- lExternalLocalPort
[in] The external port of the NAT.
Return Value
This method can return an RTC_E_ constant, as well as any of the standard COM and ADSI return values. The following table shows additional information about a specific return value.
| Value | Description |
|---|---|
RTC_E_MAPPING_INVALID |
NAT mapping was invalid. |
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |