IVoIPMgr::Initialize

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 and later.
Header: Voipmanager.h, Voipmanager.idl.
Link Library: Voipguid.lib.

See Also

VoIP Application Interface Layer Architecture | VoIP Application Interface Layer Reference | IVoIPMgr::Parameters | IVoIPMgr::Uninitialize | VoIPMgrParameters | IVoIPUI | IVoIPUI::OnSystemEvent

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.