Share via


IRTCClient2::InitializeEx

The InitializeEx method specifies additional information about the mode of initialization, such as whether the media stack or support for UPnP will be disabled. This method initializes the client object and must be called before any other methods. This method supersedes IRTCClient::Initialize.

HRESULT InitializeEx(longlFlags);

Parameters

  • lFlags
    RTCIF_ constant specifying the mode of initialization for the Client API. This parameter specifies behaviors that cannot be changed for the duration of the client object.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_CLIENT_ALREADY_INITIALIZED The client object has already been initialized.
RTC_E_CLIENT_ALREADY_SHUT_DOWN The client object has already been shut down.
RTC_E_INVALID_PORT RANGE 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 the 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 65535, and the value of MinSipDynamicPort in the registry must not be less than 1024.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClient2 is defined as 0C91D71D-1064-42da-BFA5-572BEB8EEA84.

See Also

IRTCClient2