The IRTCPortManager interface contains methods to specify the NAT mappings. For each media type, an IP address and port pair will be provided by the methods on this interface. A pointer to this interface must be supplied to the RTC Client API via the IRTCSessionPortManagement::SetPortManager method.
Note Any calls to the IRTCPortManager methods must be processed in a timely fashion. Long delays could cause the session to fail due to a time-out. It is strongly recommended that the port manager have port mappings ready before the application starts or accepts a session. If the port mappings are not available when an incoming session event is received (RTCSS_INCOMING), it is recommended that the application return a failure code. The IRTCPortManager methods must not directly or indirectly call any RTC Client API.
Methods in Vtable Order
The IRTCPortManager interface inherits the methods of the standard COM interface IUnknown.
In addition, IRTCPortManager defines the following methods.
|GetMapping||Used by the client API to obtain an external IP address and port on the NAT as well as the internal IP address and port pair.|
|UpdateRemoteAddress||Informs the application that the remote address has been updated for a given address and port pair..|
|ReleaseMapping||Allows the RTC Client API to inform the application that the NAT mapping is no longer required. The application elects to release the NAT mapping.|
Client: Requires Windows XP SP1.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCPortManager is defined as DA77C14B-6208-43ca-8DDF-5B60A0A69FAC.