IVoIPMgr::Initialize (Windows CE 5.0)
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