IRTCClient2::AllowedPorts

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This method sets or gets the ports the client uses to listen for incoming sessions.

Syntax

HRESULT put_AllowedPorts(
  long lTransport,
  RTC_LISTEN_MODE penMode
);
HRESULT get_AllowedPorts(
  long lTransport,
  RTC_LISTEN_MODE* penMode
);

Parameters

• lTransport
  [in] Contains the transport type.

• penMode
  [in, out] An RTC_LISTEN_MODE enumeration that contains the listen mode.

Return Value

This method can return an RTC_E_ constant.

The following table shows additional information about a specific return value.

Value	Meaning
RTC_E_NOT_ALLOWED	The IRTCClient::ListenForIncomingSessions method has been called.

Remarks

The RTC_LISTEN_MODE value in the penMode parameter can be used to open static and dynamic ports to listen for incoming sessions.

Unless required, it is best not to open static port 5060. As a well-known port, it is more susceptible to attack.

If put_AllowedPorts is called after the listen mode is set or retrieved using IRTCClient::ListenForIncomingSessions, the RTC Client API returns an RTC_E_NOT_ALLOWED error.

Incoming sessions are not secure if the application does not set the listen mode to disallow static and dynamic ports (RTCLM_NONE), and does not specify the TLS transport in the profile.

Requirements

Header	rtccore.h, rtccore.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

IRTCClient2
IRTCClient::ListenForIncomingSessions
RTC_LISTEN_MODE