IRTCClient2::InitializeEx

  • Article

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

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This method specifies additional information about the mode of initialization, such as disabling for the media stack or UPnP support.

This method initializes the client and must be called before other methods.

This method supersedes IRTCClient::Initialize.

Syntax

HRESULT InitializeEx(
  long lFlags
);

Parameters

  • lFlags
    [in] RTCIF_ constant specifying the mode of initialization for the RTC Client API.

    This parameter specifies behaviors that cannot be changed for the duration of the client object.

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_INVALID_PORTRANGE

This error code is returned if the port range values set under the registry key HKLM\Software\Policies\Microsoft\Windows\RTC\PortRange are not valid.

The values in the registry are considered to be invalid if only one of two range values, MinSipDynamicPort and MaxSipDynamicPort, is set in the registry and the other one is missing.

The value of MaxSipDynamicPort in the registry must not be greater than 65,535.

The value of MinSipDynamicPort in the registry must not be less than 1,024.

Remarks

If you call this method and specify the flags RTCIF_ENABLE_SYMMETRIC_UDP_SIGNALING|RTCIF_PREFER_STATIC_PORT_FOR_SYMMETRIC_UDP, but you do not set the listening mode appropriately, the RTC Client API will still choose the dynamic symmetric port instead of the static port (5060). To ensure that RTC Client API chooses the static port (5060), you must call IRTCClient::put_ListenForIncomingSessions, passing in RTCLM_BOTH, after you call this method.

Requirements

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

See Also

Reference

IRTCClient::ListenForIncomingSessions
IRTCClient2
IRTCClient::Initialize
RTC_LISTEN_MODE