Share via


IVoIPMgr::Initialize (Windows CE 5.0)

Send Feedback

Note   As of Windows CE 5.0, this method is no longer supported and always returns E_NOTIMPL. Instead of using this method, you should use IVoIPMgr2::InitializeEx. The remainder of this topic applies only to Windows CE 4.2. For more information about migrating applications that use this method, see Migrating to New Initialization and Provisioning APIs.

This method initializes the VoIP manager. Initialization includes provisioning of the phone, attempts to register with the SIP server, and creation of subsequent data structures (databases, etc). This method must be called before any other manager methods. Otherwise, all methods related to setting parameters and receiving and making calls will fail with a VOIP_E_NONINITIALIZED return value.

HRESULT Initialize(   IVoIPUI* piUI,VoIPMgrParameters*pvmpMgrParams);

Parameters

  • piUI
    [in] Pointer to the IVoIPUI interface to receive asynchronous callback events from the VoIP manager.
  • pvmpMgrParams
    [in] Pointer to a VoIPMgrParameters structure that contains the parameters necessary to initialize the directory client and register with the SIP server. Some or all structure fields are filled in. The VoIP manager will fill the rest of the structure with defaults.

Return Values

The following table shows the possible return values.

Value Description
VOIP_E_ALREADYINITIALIZED The VoIP manager is already initialized.
VOIP_E_BUSY The manager is busy.
VOIP_E_NOMEDIAMGR No media manager is available for use by the VoIP manager.
VOIP_E_PROVISIONING_FAILED The method failed to provision the phone during initialization.

Remarks

This method posts its progress by using IVoIPUI::OnSystemEvent.

Requirements

OS Versions: Windows CE .NET 4.2.
Header: Voipmanager.h, Voipmanager.idl.
Link Library: Voipguid.lib.

See Also

VAIL Architecture | VAIL Reference | IVoIPMgr::Parameters | IVoIPMgr::Uninitialize | VoIPMgrParameters | IVoIPMgr2::InitializeEx | IVoIPUI | IVoIPUI::OnSystemEvent

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.