INmManager::Initialize
The Initialize method activates the Conference Manager object and enables the calling application to register itself with the conference services. NetMeeting client applications can choose how to interact with the NetMeeting user interface (UI) with this method.
HRESULT Initialize(
[in, out] ULONG*puOptions,[in, out] ULONG*pReserved);
Parameters
- puOptions
Pointer to a value from the NM_INIT_* constants that specify the initialization options to use. This parameter influences whether notifications are sent to client applications for calls and other conference events that applications may display for the end user. If this parameter is NULL, the default is used. - pReserved
Unused parameter reserved for future use.
Return Values
NetMeeting client applications can use the SUCCEEDED and FAILED macros in winerror.h to check return values.
Return values can include remote procedure call (RPC) layer errors or any of the following values:
- S_OK
The Conference Manager object was initialized successfully. - E_FAIL
The Conference Manager object was already initialized or the conference services are not available.
Remarks
When an application accepts a call, the NetMeeting UI is displayed unless puOptions is set to NM_INIT_CONTROL. Only applications that control the NetMeeting UI are notified of incoming calls.
Note When the NetMeeting UI is not active, clients that have initialized with NM_INIT_CONTROL receive incoming call notifications. When NetMeeting is in this mode, the NetMeeting UI cannot be launched (using the icon or otherwise trying to start NetMeeting), but the UI may have been active before INmManager::Initialize was called.
For NetMeeting 3, NM_INIT_BACKGROUND is the preferred setting for NetMeeting client applications. This value lets NetMeeting handle the display of all dialogs and other UI elements and the application can ignore NmUI method notifications (INmManagerNotify::NmUI, INmCallNotify::NmUI, INmChannelNotify::NmUI, and INmConferenceNotify::NmUI).
Versions earlier than NetMeeting 3 need to use NM_INIT_CONTROL to suppress the NetMeeting UI. If NM_INIT_CONTROL is passed into and returned from this method, the INmManagerNotify::NmUI method must be implemented, and the application must handle the display of all dialogs and other user interface elements.
Requirements
** Windows NT/2000:** Requires Windows NT 4.0 SP3 or later.
** Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
** Header:** Imsconf2.idl.