IRTCClientPortManagement:IUnknown (Windows CE 5.0)
This interface provides methods that allow the client application to supply additional IP addresses and ports on which the RTC Client API can listen.
It is primarily used by applications implementing the NAT Traversal (IRTCClient::NetworkAddresses) method and NAT Mapping (IRTCSessionPortManagement and IRTCPortManager) interfaces.
The IRTCClientPortManagement interface provides the means to manage ports for incoming traffic when the application is situated behind a non-UPnP-enabled NAT.
The application communicates the port for incoming traffic out-of-band to the remote client.
After the session request arrives and creates the incoming session, the application sets the port manager on the session object.
The IRTCSessionPortManagement interface provides the IRTCPortManager interface to the RTC Client API. The RTC Client API uses this interface to obtain the mappings for internal and external IP addresses and ports for the session.
For outgoing sessions, the application must set the IRTCPortManager interface on the session object before the session request is sent. The IRTCPortManager interface is set before accepting an incoming session.
Methods
The following table shows the methods for this interface in vtable order.
This is the order in which the compiler calls the methods.
Like all COM interfaces, this interface inherits the methods for the IUnknown interface.
| Method | Description |
|---|---|
| StartListenAddressAndPort | Specifies an IP address and port on which the RTC Client API can listen for incoming requests. |
| StopListenAddressAndPort | Specifies an IP address and port on which the RTC Client API should stop listening for incoming requests. |
| GetPortRange | Retrieves the minimum and maximum values of the ports configured for the specified port type. |
Obtaining a Pointer
The IRTCClientPortmanagement interface can be obtained by calling QueryInterface on the IRTCClient2 interface.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
RTC Client API Interfaces | IRTCClient2 | IRTCPortManager | IRTCSessionPortManagement | QueryInterface
Send Feedback on this topic to the authors