IRTCClient::Initialize

The Initialize method initializes the Client object. This must be called before any other methods are called on this interface; otherwise, the other methods will return RTC_NOT_INITIALIZED.

HRESULT Initialize();

Parameters

This method has no parameters.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_E_CLIENT_ALREADY_INITIALIZED The client is already initialized.
RTC_E_CLIENT_ALREADY_SHUT_DOWN The client has already 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

Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClient is defined as 07829e45-9a34-408e-a011-bddf13487cd1.

See Also

Initialize RTC, IRTCClient, IRTCClient::Shutdown