SessionImpl.cpp@ 76690

Last change on this file since 76690 was 76553, checked in by vboxsync, 6 years ago
scm --update-copyright-year
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 38.1 KB

Line
1	/* $Id: SessionImpl.cpp 76553 2019-01-01 01:45:53Z vboxsync $ */
2	/** @file
3	* VBox Client Session COM Class implementation in VBoxC.
4	*/
5
6	/*
7	* Copyright (C) 2006-2019 Oracle Corporation
8	*
9	* This file is part of VirtualBox Open Source Edition (OSE), as
10	* available from http://www.virtualbox.org. This file is free software;
11	* you can redistribute it and/or modify it under the terms of the GNU
12	* General Public License (GPL) as published by the Free Software
13	* Foundation, in version 2 as it comes in the "COPYING" file of the
14	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16	*/
17
18	#define LOG_GROUP LOG_GROUP_MAIN_SESSION
19	#include "LoggingNew.h"
20
21	#include "SessionImpl.h"
22	#include "ConsoleImpl.h"
23	#include "Global.h"
24	#include "ClientTokenHolder.h"
25
26	#include "AutoCaller.h"
27
28	#include <iprt/errcore.h>
29	#include <iprt/process.h>
30
31
32	/**
33	* Local macro to check whether the session is open and return an error if not.
34	* @note Don't forget to do \|Auto[Reader]Lock alock (this);\| before using this
35	* macro.
36	*/
37	#define CHECK_OPEN() \
38	do { \
39	if (mState != SessionState_Locked) \
40	return setError(E_UNEXPECTED, tr ("The session is not locked (session state: %s)"), \
41	Global::stringifySessionState(mState)); \
42	} while (0)
43
44	// constructor / destructor
45	/////////////////////////////////////////////////////////////////////////////
46
47	Session::Session()
48	{
49	}
50
51	Session::~Session()
52	{
53	}
54
55	HRESULT Session::FinalConstruct()
56	{
57	LogFlowThisFunc(("\n"));
58
59	HRESULT rc = init();
60
61	BaseFinalConstruct();
62
63	return rc;
64	}
65
66	void Session::FinalRelease()
67	{
68	LogFlowThisFunc(("\n"));
69
70	uninit();
71
72	BaseFinalRelease();
73	}
74
75	// public initializer/uninitializer for internal purposes only
76	/////////////////////////////////////////////////////////////////////////////
77
78	/**
79	* Initializes the Session object.
80	*/
81	HRESULT Session::init()
82	{
83	/* Enclose the state transition NotReady->InInit->Ready */
84	AutoInitSpan autoInitSpan(this);
85	AssertReturn(autoInitSpan.isOk(), E_FAIL);
86
87	LogFlowThisFuncEnter();
88
89	mState = SessionState_Unlocked;
90	mType = SessionType_Null;
91
92	mClientTokenHolder = NULL;
93
94	/* Confirm a successful initialization when it's the case */
95	autoInitSpan.setSucceeded();
96
97	LogFlowThisFuncLeave();
98
99	return S_OK;
100	}
101
102	/**
103	* Uninitializes the Session object.
104	*
105	* @note Locks this object for writing.
106	*/
107	void Session::uninit()
108	{
109	LogFlowThisFuncEnter();
110
111	/* Enclose the state transition Ready->InUninit->NotReady */
112	AutoUninitSpan autoUninitSpan(this);
113	if (autoUninitSpan.uninitDone())
114	{
115	LogFlowThisFunc(("Already uninitialized.\n"));
116	LogFlowThisFuncLeave();
117	return;
118	}
119
120	/* close() needs write lock */
121	AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
122
123	if (mState != SessionState_Unlocked)
124	{
125	Assert(mState == SessionState_Locked \|\|
126	mState == SessionState_Spawning);
127
128	HRESULT rc = i_unlockMachine(true /* aFinalRelease /, false / aFromServer */, alock);
129	AssertComRC(rc);
130	}
131
132	LogFlowThisFuncLeave();
133	}
134
135	// ISession properties
136	/////////////////////////////////////////////////////////////////////////////
137
138	HRESULT Session::getState(SessionState_T *aState)
139	{
140	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
141
142	*aState = mState;
143
144	return S_OK;
145	}
146
147	HRESULT Session::getType(SessionType_T *aType)
148	{
149	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
150
151	CHECK_OPEN();
152
153	*aType = mType;
154	return S_OK;
155	}
156
157	HRESULT Session::getName(com::Utf8Str &aName)
158	{
159	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
160
161	aName = mName;
162	return S_OK;
163	}
164
165	HRESULT Session::setName(const com::Utf8Str &aName)
166	{
167	AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
168
169	if (mState != SessionState_Unlocked)
170	return setError(VBOX_E_INVALID_OBJECT_STATE, tr("Trying to set name for a session which is not in state \"unlocked\""));
171
172	mName = aName;
173	return S_OK;
174	}
175
176	HRESULT Session::getMachine(ComPtr<IMachine> &aMachine)
177	{
178	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
179
180	CHECK_OPEN();
181
182	HRESULT rc;
183	#ifndef VBOX_COM_INPROC_API_CLIENT
184	if (mConsole)
185	rc = mConsole->i_machine().queryInterfaceTo(aMachine.asOutParam());
186	else
187	#endif
188	rc = mRemoteMachine.queryInterfaceTo(aMachine.asOutParam());
189	if (FAILED(rc))
190	{
191	#ifndef VBOX_COM_INPROC_API_CLIENT
192	if (mConsole)
193	setError(rc, tr("Failed to query the session machine"));
194	else
195	#endif
196	if (FAILED_DEAD_INTERFACE(rc))
197	setError(rc, tr("Peer process crashed"));
198	else
199	setError(rc, tr("Failed to query the remote session machine"));
200	}
201
202	return rc;
203	}
204
205	HRESULT Session::getConsole(ComPtr<IConsole> &aConsole)
206	{
207	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
208
209	CHECK_OPEN();
210
211	HRESULT rc = S_OK;
212	#ifndef VBOX_COM_INPROC_API_CLIENT
213	if (mConsole)
214	rc = mConsole.queryInterfaceTo(aConsole.asOutParam());
215	else
216	#endif
217	rc = mRemoteConsole.queryInterfaceTo(aConsole.asOutParam());
218
219	if (FAILED(rc))
220	{
221	#ifndef VBOX_COM_INPROC_API_CLIENT
222	if (mConsole)
223	setError(rc, tr("Failed to query the console"));
224	else
225	#endif
226	if (FAILED_DEAD_INTERFACE(rc))
227	setError(rc, tr("Peer process crashed"));
228	else
229	setError(rc, tr("Failed to query the remote console"));
230	}
231
232	return rc;
233	}
234
235	// ISession methods
236	/////////////////////////////////////////////////////////////////////////////
237	HRESULT Session::unlockMachine()
238	{
239	LogFlowThisFunc(("mState=%d, mType=%d\n", mState, mType));
240
241	/* close() needs write lock */
242	AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
243
244	CHECK_OPEN();
245	return i_unlockMachine(false /* aFinalRelease /, false / aFromServer */, alock);
246	}
247
248	// IInternalSessionControl methods
249	/////////////////////////////////////////////////////////////////////////////
250	HRESULT Session::getPID(ULONG *aPid)
251	{
252	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
253
254	*aPid = (ULONG)RTProcSelf();
255	AssertCompile(sizeof(*aPid) == sizeof(RTPROCESS));
256
257	return S_OK;
258	}
259
260	HRESULT Session::getRemoteConsole(ComPtr<IConsole> &aConsole)
261	{
262	LogFlowThisFuncEnter();
263
264	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
265
266	#ifndef VBOX_COM_INPROC_API_CLIENT
267	AssertMsgReturn(mType == SessionType_WriteLock && !!mConsole,
268	("This is not a direct session!\n"),
269	VBOX_E_INVALID_OBJECT_STATE);
270
271	/* return a failure if the session already transitioned to Closing
272	* but the server hasn't processed Machine::OnSessionEnd() yet. */
273	if (mState != SessionState_Locked)
274	return VBOX_E_INVALID_VM_STATE;
275
276	mConsole.queryInterfaceTo(aConsole.asOutParam());
277
278	LogFlowThisFuncLeave();
279
280	return S_OK;
281
282	#else /* VBOX_COM_INPROC_API_CLIENT */
283	RT_NOREF(aConsole);
284	AssertFailed();
285	return VBOX_E_INVALID_OBJECT_STATE;
286	#endif /* VBOX_COM_INPROC_API_CLIENT */
287	}
288
289	HRESULT Session::getNominalState(MachineState_T *aNominalState)
290	{
291	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
292	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
293	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
294	#ifndef VBOX_COM_INPROC_API_CLIENT
295	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
296
297	return mConsole->i_getNominalState(*aNominalState);
298	#else
299	RT_NOREF(aNominalState);
300	AssertFailed();
301	return E_NOTIMPL;
302	#endif
303	}
304
305	#ifndef VBOX_WITH_GENERIC_SESSION_WATCHER
306	HRESULT Session::assignMachine(const ComPtr<IMachine> &aMachine,
307	LockType_T aLockType,
308	const com::Utf8Str &aTokenId)
309	#else
310	HRESULT Session::assignMachine(const ComPtr<IMachine> &aMachine,
311	LockType_T aLockType,
312	const ComPtr<IToken> &aToken)
313	#endif /* !VBOX_WITH_GENERIC_SESSION_WATCHER */
314	{
315	AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
316
317	AssertReturn(mState == SessionState_Unlocked, VBOX_E_INVALID_VM_STATE);
318
319	if (!aMachine)
320	{
321	/*
322	* A special case: the server informs us that this session has been
323	* passed to IMachine::launchVMProcess() so this session will become
324	* remote (but not existing) when AssignRemoteMachine() is called.
325	*/
326
327	AssertReturn(mType == SessionType_Null, VBOX_E_INVALID_OBJECT_STATE);
328	mType = SessionType_Remote;
329	mState = SessionState_Spawning;
330
331	return S_OK;
332	}
333
334	/* query IInternalMachineControl interface */
335	mControl = aMachine;
336	AssertReturn(!!mControl, E_FAIL);
337
338	HRESULT rc = S_OK;
339	#ifndef VBOX_COM_INPROC_API_CLIENT
340	if (aLockType == LockType_VM)
341	{
342	/* This is what is special about VM processes: they have a Console
343	* object which is the root of all VM related activity. */
344	rc = mConsole.createObject();
345	AssertComRCReturn(rc, rc);
346
347	rc = mConsole->init(aMachine, mControl, aLockType);
348	AssertComRCReturn(rc, rc);
349	}
350	else
351	mRemoteMachine = aMachine;
352	#else
353	RT_NOREF(aLockType);
354	mRemoteMachine = aMachine;
355	#endif
356
357	#ifndef VBOX_WITH_GENERIC_SESSION_WATCHER
358	Utf8Str strTokenId(aTokenId);
359	Assert(!strTokenId.isEmpty());
360	#else /* VBOX_WITH_GENERIC_SESSION_WATCHER */
361	Assert(!aToken.isNull());
362	#endif /* VBOX_WITH_GENERIC_SESSION_WATCHER */
363	/* create the machine client token */
364	try
365	{
366	#ifndef VBOX_WITH_GENERIC_SESSION_WATCHER
367	mClientTokenHolder = new ClientTokenHolder(strTokenId);
368	#else /* VBOX_WITH_GENERIC_SESSION_WATCHER */
369	mClientTokenHolder = new ClientTokenHolder(aToken);
370	#endif /* VBOX_WITH_GENERIC_SESSION_WATCHER */
371	if (!mClientTokenHolder->isReady())
372	{
373	delete mClientTokenHolder;
374	mClientTokenHolder = NULL;
375	rc = E_FAIL;
376	}
377	}
378	catch (std::bad_alloc &)
379	{
380	rc = E_OUTOFMEMORY;
381	}
382
383	/*
384	* Reference the VirtualBox object to ensure the server is up
385	* until the session is closed
386	*/
387	if (SUCCEEDED(rc))
388	rc = aMachine->COMGETTER(Parent)(mVirtualBox.asOutParam());
389
390	if (SUCCEEDED(rc))
391	{
392	mType = SessionType_WriteLock;
393	mState = SessionState_Locked;
394	}
395	else
396	{
397	/* some cleanup */
398	mControl.setNull();
399	#ifndef VBOX_COM_INPROC_API_CLIENT
400	if (!mConsole.isNull())
401	{
402	mConsole->uninit();
403	mConsole.setNull();
404	}
405	#endif
406	}
407
408	return rc;
409	}
410
411	HRESULT Session::assignRemoteMachine(const ComPtr<IMachine> &aMachine,
412	const ComPtr<IConsole> &aConsole)
413
414	{
415	AssertReturn(aMachine, E_INVALIDARG);
416
417	AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
418
419	AssertReturn(mState == SessionState_Unlocked \|\|
420	mState == SessionState_Spawning, VBOX_E_INVALID_VM_STATE);
421
422	HRESULT rc = E_FAIL;
423
424	/* query IInternalMachineControl interface */
425	mControl = aMachine;
426	AssertReturn(!!mControl, E_FAIL);
427
428	/// @todo (dmik)
429	// currently, the remote session returns the same machine and
430	// console objects as the direct session, thus giving the
431	// (remote) client full control over the direct session. For the
432	// console, it is the desired behavior (the ability to control
433	// VM execution is a must for the remote session). What about
434	// the machine object, we may want to prevent the remote client
435	// from modifying machine data. In this case, we must:
436	// 1) assign the Machine object (instead of the SessionMachine
437	// object that is passed to this method) to mRemoteMachine;
438	// 2) remove GetMachine() property from the IConsole interface
439	// because it always returns the SessionMachine object
440	// (alternatively, we can supply a separate IConsole
441	// implementation that will return the Machine object in
442	// response to GetMachine()).
443
444	mRemoteMachine = aMachine;
445	mRemoteConsole = aConsole;
446
447	/*
448	* Reference the VirtualBox object to ensure the server is up
449	* until the session is closed
450	*/
451	rc = aMachine->COMGETTER(Parent)(mVirtualBox.asOutParam());
452
453	if (SUCCEEDED(rc))
454	{
455	/*
456	* RemoteSession type can be already set by AssignMachine() when its
457	* argument is NULL (a special case)
458	*/
459	if (mType != SessionType_Remote)
460	mType = SessionType_Shared;
461	else
462	Assert(mState == SessionState_Spawning);
463
464	mState = SessionState_Locked;
465	}
466	else
467	{
468	/* some cleanup */
469	mControl.setNull();
470	mRemoteMachine.setNull();
471	mRemoteConsole.setNull();
472	}
473
474	LogFlowThisFunc(("rc=%08X\n", rc));
475	LogFlowThisFuncLeave();
476
477	return rc;
478	}
479
480	HRESULT Session::updateMachineState(MachineState_T aMachineState)
481	{
482
483	if (getObjectState().getState() != ObjectState::Ready)
484	{
485	/*
486	* We might have already entered Session::uninit() at this point, so
487	* return silently (not interested in the state change during uninit)
488	*/
489	LogFlowThisFunc(("Already uninitialized.\n"));
490	return S_OK;
491	}
492
493	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
494
495	if (mState == SessionState_Unlocking)
496	{
497	LogFlowThisFunc(("Already being unlocked.\n"));
498	return S_OK;
499	}
500
501	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
502	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
503
504	AssertReturn(!mControl.isNull(), E_FAIL);
505	#ifndef VBOX_COM_INPROC_API_CLIENT
506	AssertReturn(!mConsole.isNull(), E_FAIL);
507
508	return mConsole->i_updateMachineState(aMachineState);
509	#else
510	RT_NOREF(aMachineState);
511	return S_OK;
512	#endif
513	}
514
515	HRESULT Session::uninitialize()
516	{
517	LogFlowThisFuncEnter();
518
519	AutoCaller autoCaller(this);
520
521	HRESULT rc = S_OK;
522
523	if (getObjectState().getState() == ObjectState::Ready)
524	{
525	/* close() needs write lock */
526	AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
527
528	LogFlowThisFunc(("mState=%s, mType=%d\n", Global::stringifySessionState(mState), mType));
529
530	if (mState == SessionState_Unlocking)
531	{
532	LogFlowThisFunc(("Already being unlocked.\n"));
533	return S_OK;
534	}
535
536	if ( mState == SessionState_Locked
537	\|\| mState == SessionState_Spawning)
538	{ /* likely */ }
539	else
540	{
541	#ifndef DEBUG_bird /* bird: hitting this all the time running tdAddBaseic1.py. */
542	AssertMsgFailed(("Session is in wrong state (%d), expected locked (%d) or spawning (%d)\n",
543	mState, SessionState_Locked, SessionState_Spawning));
544	#endif
545	return VBOX_E_INVALID_VM_STATE;
546	}
547
548	/* close ourselves */
549	rc = i_unlockMachine(false /* aFinalRelease /, true / aFromServer */, alock);
550	}
551	else if (getObjectState().getState() == ObjectState::InUninit)
552	{
553	/*
554	* We might have already entered Session::uninit() at this point,
555	* return silently
556	*/
557	LogFlowThisFunc(("Already uninitialized.\n"));
558	}
559	else
560	{
561	Log1WarningThisFunc(("UNEXPECTED uninitialization!\n"));
562	rc = autoCaller.rc();
563	}
564
565	LogFlowThisFunc(("rc=%08X\n", rc));
566	LogFlowThisFuncLeave();
567
568	return rc;
569	}
570
571	HRESULT Session::onNetworkAdapterChange(const ComPtr<INetworkAdapter> &aNetworkAdapter,
572	BOOL aChangeAdapter)
573
574	{
575	LogFlowThisFunc(("\n"));
576
577	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
578	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
579	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
580	#ifndef VBOX_COM_INPROC_API_CLIENT
581	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
582
583	return mConsole->i_onNetworkAdapterChange(aNetworkAdapter, aChangeAdapter);
584	#else
585	RT_NOREF(aNetworkAdapter, aChangeAdapter);
586	return S_OK;
587	#endif
588	}
589
590	HRESULT Session::onAudioAdapterChange(const ComPtr<IAudioAdapter> &aAudioAdapter)
591	{
592	LogFlowThisFunc(("\n"));
593
594	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
595	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
596	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
597	#ifndef VBOX_COM_INPROC_API_CLIENT
598	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
599
600	return mConsole->i_onAudioAdapterChange(aAudioAdapter);
601	#else
602	RT_NOREF(aAudioAdapter);
603	return S_OK;
604	#endif
605
606	}
607
608	HRESULT Session::onSerialPortChange(const ComPtr<ISerialPort> &aSerialPort)
609	{
610	LogFlowThisFunc(("\n"));
611
612	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
613	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
614	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
615	#ifndef VBOX_COM_INPROC_API_CLIENT
616	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
617
618	return mConsole->i_onSerialPortChange(aSerialPort);
619	#else
620	RT_NOREF(aSerialPort);
621	return S_OK;
622	#endif
623	}
624
625	HRESULT Session::onParallelPortChange(const ComPtr<IParallelPort> &aParallelPort)
626	{
627	LogFlowThisFunc(("\n"));
628
629	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
630	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
631	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
632	#ifndef VBOX_COM_INPROC_API_CLIENT
633	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
634
635	return mConsole->i_onParallelPortChange(aParallelPort);
636	#else
637	RT_NOREF(aParallelPort);
638	return S_OK;
639	#endif
640	}
641
642	HRESULT Session::onStorageControllerChange()
643	{
644	LogFlowThisFunc(("\n"));
645
646	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
647	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
648	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
649	#ifndef VBOX_COM_INPROC_API_CLIENT
650	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
651
652	return mConsole->i_onStorageControllerChange();
653	#else
654	return S_OK;
655	#endif
656	}
657
658	HRESULT Session::onMediumChange(const ComPtr<IMediumAttachment> &aMediumAttachment,
659	BOOL aForce)
660	{
661	LogFlowThisFunc(("\n"));
662
663	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
664	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
665	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
666	#ifndef VBOX_COM_INPROC_API_CLIENT
667	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
668
669	return mConsole->i_onMediumChange(aMediumAttachment, aForce);
670	#else
671	RT_NOREF(aMediumAttachment, aForce);
672	return S_OK;
673	#endif
674	}
675
676	HRESULT Session::onCPUChange(ULONG aCpu, BOOL aAdd)
677	{
678	LogFlowThisFunc(("\n"));
679
680	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
681	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
682	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
683	#ifndef VBOX_COM_INPROC_API_CLIENT
684	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
685
686	return mConsole->i_onCPUChange(aCpu, aAdd);
687	#else
688	RT_NOREF(aCpu, aAdd);
689	return S_OK;
690	#endif
691	}
692
693	HRESULT Session::onCPUExecutionCapChange(ULONG aExecutionCap)
694	{
695	LogFlowThisFunc(("\n"));
696
697	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
698	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
699	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
700	#ifndef VBOX_COM_INPROC_API_CLIENT
701	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
702
703	return mConsole->i_onCPUExecutionCapChange(aExecutionCap);
704	#else
705	RT_NOREF(aExecutionCap);
706	return S_OK;
707	#endif
708	}
709
710	HRESULT Session::onVRDEServerChange(BOOL aRestart)
711	{
712	LogFlowThisFunc(("\n"));
713
714	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
715	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
716	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
717	#ifndef VBOX_COM_INPROC_API_CLIENT
718	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
719
720	return mConsole->i_onVRDEServerChange(aRestart);
721	#else
722	RT_NOREF(aRestart);
723	return S_OK;
724	#endif
725	}
726
727	HRESULT Session::onRecordingChange(BOOL aEnable)
728	{
729	LogFlowThisFunc(("\n"));
730
731	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
732	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
733	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
734	#ifndef VBOX_COM_INPROC_API_CLIENT
735	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
736
737	return mConsole->i_onRecordingChange(aEnable);
738	#else
739	RT_NOREF(aEnable);
740	return S_OK;
741	#endif
742	}
743
744	HRESULT Session::onUSBControllerChange()
745	{
746	LogFlowThisFunc(("\n"));
747
748	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
749	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
750	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
751	#ifndef VBOX_COM_INPROC_API_CLIENT
752	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
753
754	return mConsole->i_onUSBControllerChange();
755	#else
756	return S_OK;
757	#endif
758	}
759
760	HRESULT Session::onSharedFolderChange(BOOL aGlobal)
761	{
762	LogFlowThisFunc(("\n"));
763
764	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
765	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
766	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
767	#ifndef VBOX_COM_INPROC_API_CLIENT
768	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
769
770	return mConsole->i_onSharedFolderChange(aGlobal);
771	#else
772	RT_NOREF(aGlobal);
773	return S_OK;
774	#endif
775	}
776
777	HRESULT Session::onClipboardModeChange(ClipboardMode_T aClipboardMode)
778	{
779	LogFlowThisFunc(("\n"));
780
781	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
782	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
783	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
784	#ifndef VBOX_COM_INPROC_API_CLIENT
785	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
786
787	return mConsole->i_onClipboardModeChange(aClipboardMode);
788	#else
789	RT_NOREF(aClipboardMode);
790	return S_OK;
791	#endif
792	}
793
794	HRESULT Session::onDnDModeChange(DnDMode_T aDndMode)
795	{
796	LogFlowThisFunc(("\n"));
797
798	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
799	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
800	#ifndef VBOX_COM_INPROC_API_CLIENT
801	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
802	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
803
804	return mConsole->i_onDnDModeChange(aDndMode);
805	#else
806	RT_NOREF(aDndMode);
807	return S_OK;
808	#endif
809	}
810
811	HRESULT Session::onUSBDeviceAttach(const ComPtr<IUSBDevice> &aDevice,
812	const ComPtr<IVirtualBoxErrorInfo> &aError,
813	ULONG aMaskedInterfaces,
814	const com::Utf8Str &aCaptureFilename)
815	{
816	LogFlowThisFunc(("\n"));
817
818	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
819	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
820	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
821	#ifndef VBOX_COM_INPROC_API_CLIENT
822	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
823
824	return mConsole->i_onUSBDeviceAttach(aDevice, aError, aMaskedInterfaces, aCaptureFilename);
825	#else
826	RT_NOREF(aDevice, aError, aMaskedInterfaces, aCaptureFilename);
827	return S_OK;
828	#endif
829	}
830
831	HRESULT Session::onUSBDeviceDetach(const com::Guid &aId,
832	const ComPtr<IVirtualBoxErrorInfo> &aError)
833	{
834	LogFlowThisFunc(("\n"));
835
836	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
837	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
838	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
839	#ifndef VBOX_COM_INPROC_API_CLIENT
840	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
841
842	return mConsole->i_onUSBDeviceDetach(aId.toUtf16().raw(), aError);
843	#else
844	RT_NOREF(aId, aError);
845	return S_OK;
846	#endif
847	}
848
849	HRESULT Session::onShowWindow(BOOL aCheck, BOOL aCanShow, LONG64 aWinId)
850	{
851	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
852
853	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
854	#ifndef VBOX_COM_INPROC_API_CLIENT
855	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
856	#endif
857
858	if (mState != SessionState_Locked)
859	{
860	/* the call from Machine issued when the session is open can arrive
861	* after the session starts closing or gets closed. Note that when
862	* aCheck is false, we return E_FAIL to indicate that aWinId we return
863	* is not valid */
864	*aCanShow = FALSE;
865	*aWinId = 0;
866	return aCheck ? S_OK : E_FAIL;
867	}
868
869	#ifndef VBOX_COM_INPROC_API_CLIENT
870	return mConsole->i_onShowWindow(aCheck, aCanShow, aWinId);
871	#else
872	return S_OK;
873	#endif
874	}
875
876	HRESULT Session::onBandwidthGroupChange(const ComPtr<IBandwidthGroup> &aBandwidthGroup)
877	{
878	LogFlowThisFunc(("\n"));
879
880	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
881	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
882	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
883	#ifndef VBOX_COM_INPROC_API_CLIENT
884	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
885
886	return mConsole->i_onBandwidthGroupChange(aBandwidthGroup);
887	#else
888	RT_NOREF(aBandwidthGroup);
889	return S_OK;
890	#endif
891	}
892
893	HRESULT Session::onStorageDeviceChange(const ComPtr<IMediumAttachment> &aMediumAttachment, BOOL aRemove, BOOL aSilent)
894	{
895	LogFlowThisFunc(("\n"));
896
897	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
898	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
899	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
900	#ifndef VBOX_COM_INPROC_API_CLIENT
901	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
902
903	return mConsole->i_onStorageDeviceChange(aMediumAttachment, aRemove, aSilent);
904	#else
905	RT_NOREF(aMediumAttachment, aRemove, aSilent);
906	return S_OK;
907	#endif
908	}
909
910	HRESULT Session::accessGuestProperty(const com::Utf8Str &aName, const com::Utf8Str &aValue, const com::Utf8Str &aFlags,
911	ULONG aAccessMode, com::Utf8Str &aRetValue, LONG64 *aRetTimestamp, com::Utf8Str &aRetFlags)
912	{
913	#ifdef VBOX_WITH_GUEST_PROPS
914	# ifndef VBOX_COM_INPROC_API_CLIENT
915	if (mState != SessionState_Locked)
916	return setError(VBOX_E_INVALID_VM_STATE,
917	tr("Machine is not locked by session (session state: %s)."),
918	Global::stringifySessionState(mState));
919	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
920	if (aName.isEmpty())
921	return E_INVALIDARG;
922	if (aAccessMode == 0 && !RT_VALID_PTR(aRetTimestamp))
923	return E_POINTER;
924
925	/* If this session is not in a VM process fend off the call. The caller
926	* handles this correctly, by doing the operation in VBoxSVC. */
927	if (!mConsole)
928	return E_ACCESSDENIED;
929
930	HRESULT hr;
931	if (aAccessMode == 2)
932	hr = mConsole->i_deleteGuestProperty(aName);
933	else if (aAccessMode == 1)
934	hr = mConsole->i_setGuestProperty(aName, aValue, aFlags);
935	else if (aAccessMode == 0)
936	hr = mConsole->i_getGuestProperty(aName, &aRetValue, aRetTimestamp, &aRetFlags);
937	else
938	hr = E_INVALIDARG;
939
940	return hr;
941	# else /* VBOX_COM_INPROC_API_CLIENT */
942	/** @todo This is nonsense, non-VM API users shouldn't need to deal with this
943	* method call, VBoxSVC should be clever enough to see that the
944	* session doesn't have a console! */
945	RT_NOREF(aName, aValue, aFlags, aAccessMode, aRetValue, aRetTimestamp, aRetFlags);
946	return E_ACCESSDENIED;
947	# endif /* VBOX_COM_INPROC_API_CLIENT */
948
949	#else /* VBOX_WITH_GUEST_PROPS */
950	ReturnComNotImplemented();
951	#endif /* VBOX_WITH_GUEST_PROPS */
952	}
953
954	HRESULT Session::enumerateGuestProperties(const com::Utf8Str &aPatterns,
955	std::vector<com::Utf8Str> &aKeys,
956	std::vector<com::Utf8Str> &aValues,
957	std::vector<LONG64> &aTimestamps,
958	std::vector<com::Utf8Str> &aFlags)
959	{
960	#if defined(VBOX_WITH_GUEST_PROPS) && !defined(VBOX_COM_INPROC_API_CLIENT)
961	if (mState != SessionState_Locked)
962	return setError(VBOX_E_INVALID_VM_STATE,
963	tr("Machine is not locked by session (session state: %s)."),
964	Global::stringifySessionState(mState));
965	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
966
967	/* If this session is not in a VM process fend off the call. The caller
968	* handles this correctly, by doing the operation in VBoxSVC. */
969	if (!mConsole)
970	return E_ACCESSDENIED;
971
972	return mConsole->i_enumerateGuestProperties(aPatterns, aKeys, aValues, aTimestamps, aFlags);
973
974	#else /* VBOX_WITH_GUEST_PROPS not defined */
975	RT_NOREF(aPatterns, aKeys, aValues, aTimestamps, aFlags);
976	ReturnComNotImplemented();
977	#endif /* VBOX_WITH_GUEST_PROPS not defined */
978	}
979
980	HRESULT Session::onlineMergeMedium(const ComPtr<IMediumAttachment> &aMediumAttachment, ULONG aSourceIdx,
981	ULONG aTargetIdx, const ComPtr<IProgress> &aProgress)
982	{
983	if (mState != SessionState_Locked)
984	return setError(VBOX_E_INVALID_VM_STATE,
985	tr("Machine is not locked by session (session state: %s)."),
986	Global::stringifySessionState(mState));
987	#ifndef VBOX_COM_INPROC_API_CLIENT
988	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
989	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
990
991	return mConsole->i_onlineMergeMedium(aMediumAttachment,
992	aSourceIdx, aTargetIdx,
993	aProgress);
994	#else
995	RT_NOREF(aMediumAttachment, aSourceIdx, aTargetIdx, aProgress);
996	AssertFailed();
997	return E_NOTIMPL;
998	#endif
999	}
1000
1001	HRESULT Session::reconfigureMediumAttachments(const std::vector<ComPtr<IMediumAttachment> > &aAttachments)
1002	{
1003	if (mState != SessionState_Locked)
1004	return setError(VBOX_E_INVALID_VM_STATE,
1005	tr("Machine is not locked by session (session state: %s)."),
1006	Global::stringifySessionState(mState));
1007	#ifndef VBOX_COM_INPROC_API_CLIENT
1008	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1009	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1010
1011	return mConsole->i_reconfigureMediumAttachments(aAttachments);
1012	#else
1013	RT_NOREF(aAttachments);
1014	AssertFailed();
1015	return E_NOTIMPL;
1016	#endif
1017	}
1018
1019	HRESULT Session::enableVMMStatistics(BOOL aEnable)
1020	{
1021	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1022	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1023	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1024	#ifndef VBOX_COM_INPROC_API_CLIENT
1025	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1026
1027	mConsole->i_enableVMMStatistics(aEnable);
1028
1029	return S_OK;
1030	#else
1031	RT_NOREF(aEnable);
1032	AssertFailed();
1033	return E_NOTIMPL;
1034	#endif
1035	}
1036
1037	HRESULT Session::pauseWithReason(Reason_T aReason)
1038	{
1039	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1040	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1041	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1042	#ifndef VBOX_COM_INPROC_API_CLIENT
1043	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1044
1045	return mConsole->i_pause(aReason);
1046	#else
1047	RT_NOREF(aReason);
1048	AssertFailed();
1049	return E_NOTIMPL;
1050	#endif
1051	}
1052
1053	HRESULT Session::resumeWithReason(Reason_T aReason)
1054	{
1055	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1056	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1057	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1058	#ifndef VBOX_COM_INPROC_API_CLIENT
1059	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1060
1061	AutoWriteLock dummyLock(mConsole COMMA_LOCKVAL_SRC_POS);
1062	return mConsole->i_resume(aReason, dummyLock);
1063	#else
1064	RT_NOREF(aReason);
1065	AssertFailed();
1066	return E_NOTIMPL;
1067	#endif
1068	}
1069
1070	HRESULT Session::saveStateWithReason(Reason_T aReason,
1071	const ComPtr<IProgress> &aProgress,
1072	const ComPtr<ISnapshot> &aSnapshot,
1073	const Utf8Str &aStateFilePath,
1074	BOOL aPauseVM, BOOL *aLeftPaused)
1075	{
1076	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1077	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1078	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1079	#ifndef VBOX_COM_INPROC_API_CLIENT
1080	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1081
1082	bool fLeftPaused = false;
1083	HRESULT rc = mConsole->i_saveState(aReason, aProgress, aSnapshot, aStateFilePath, !!aPauseVM, fLeftPaused);
1084	if (aLeftPaused)
1085	*aLeftPaused = fLeftPaused;
1086	return rc;
1087	#else
1088	RT_NOREF(aReason, aProgress, aSnapshot, aStateFilePath, aPauseVM, aLeftPaused);
1089	AssertFailed();
1090	return E_NOTIMPL;
1091	#endif
1092	}
1093
1094	HRESULT Session::cancelSaveStateWithReason()
1095	{
1096	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1097	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1098	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1099	#ifndef VBOX_COM_INPROC_API_CLIENT
1100	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1101
1102	return mConsole->i_cancelSaveState();
1103	#else
1104	AssertFailed();
1105	return E_NOTIMPL;
1106	#endif
1107	}
1108
1109	// private methods
1110	///////////////////////////////////////////////////////////////////////////////
1111
1112	/**
1113	* Unlocks a machine associated with the current session.
1114	*
1115	* @param aFinalRelease called as a result of FinalRelease()
1116	* @param aFromServer called as a result of Uninitialize()
1117	* @param aLockW The write lock this object is protected with.
1118	* Must be acquired already and will be released
1119	* and later reacquired during the unlocking.
1120	*
1121	* @note To be called only from #uninit(), ISession::UnlockMachine() or
1122	* ISession::Uninitialize().
1123	*/
1124	HRESULT Session::i_unlockMachine(bool aFinalRelease, bool aFromServer, AutoWriteLock &aLockW)
1125	{
1126	LogFlowThisFuncEnter();
1127	LogFlowThisFunc(("aFinalRelease=%d, isFromServer=%d\n",
1128	aFinalRelease, aFromServer));
1129
1130	LogFlowThisFunc(("mState=%s, mType=%d\n", Global::stringifySessionState(mState), mType));
1131
1132	Assert(aLockW.isWriteLockOnCurrentThread());
1133
1134	if (mState != SessionState_Locked)
1135	{
1136	Assert(mState == SessionState_Spawning);
1137
1138	/* The session object is going to be uninitialized before it has been
1139	* assigned a direct console of the machine the client requested to open
1140	* a remote session to using IVirtualBox:: openRemoteSession(). It is OK
1141	* only if this close request comes from the server (for example, it
1142	* detected that the VM process it started terminated before opening a
1143	* direct session). Otherwise, it means that the client is too fast and
1144	* trying to close the session before waiting for the progress object it
1145	* got from IVirtualBox:: openRemoteSession() to complete, so assert. */
1146	Assert(aFromServer);
1147
1148	mState = SessionState_Unlocked;
1149	mType = SessionType_Null;
1150
1151	Assert(!mClientTokenHolder);
1152
1153	LogFlowThisFuncLeave();
1154	return S_OK;
1155	}
1156
1157	/* go to the closing state */
1158	mState = SessionState_Unlocking;
1159
1160	if (mType == SessionType_WriteLock)
1161	{
1162	#ifndef VBOX_COM_INPROC_API_CLIENT
1163	if (!mConsole.isNull())
1164	{
1165	mConsole->uninit();
1166	mConsole.setNull();
1167	}
1168	#else
1169	mRemoteMachine.setNull();
1170	#endif
1171	}
1172	else
1173	{
1174	mRemoteMachine.setNull();
1175	mRemoteConsole.setNull();
1176	}
1177
1178	ComPtr<IProgress> progress;
1179
1180	if (!aFinalRelease && !aFromServer)
1181	{
1182	/*
1183	* We trigger OnSessionEnd() only when the session closes itself using
1184	* Close(). Note that if isFinalRelease = TRUE here, this means that
1185	* the client process has already initialized the termination procedure
1186	* without issuing Close() and the IPC channel is no more operational --
1187	* so we cannot call the server's method (it will definitely fail). The
1188	* server will instead simply detect the abnormal client death (since
1189	* OnSessionEnd() is not called) and reset the machine state to Aborted.
1190	*/
1191
1192	/*
1193	* while waiting for OnSessionEnd() to complete one of our methods
1194	* can be called by the server (for example, Uninitialize(), if the
1195	* direct session has initiated a closure just a bit before us) so
1196	* we need to release the lock to avoid deadlocks. The state is already
1197	* SessionState_Closing here, so it's safe.
1198	*/
1199	aLockW.release();
1200
1201	Assert(!aLockW.isWriteLockOnCurrentThread());
1202
1203	LogFlowThisFunc(("Calling mControl->OnSessionEnd()...\n"));
1204	HRESULT rc = mControl->OnSessionEnd(this, progress.asOutParam());
1205	LogFlowThisFunc(("mControl->OnSessionEnd()=%08X\n", rc));
1206
1207	aLockW.acquire();
1208
1209	/*
1210	* If we get E_UNEXPECTED this means that the direct session has already
1211	* been closed, we're just too late with our notification and nothing more
1212	*
1213	* bird: Seems E_ACCESSDENIED is what gets returned these days; see
1214	* ObjectState::addCaller.
1215	*/
1216	if (mType != SessionType_WriteLock && (rc == E_UNEXPECTED \|\| rc == E_ACCESSDENIED))
1217	rc = S_OK;
1218
1219	#if !defined(DEBUG_bird) && !defined(DEBUG_andy) /* I don't want clients crashing on me just because VBoxSVC went belly up. */
1220	AssertComRC(rc);
1221	#endif
1222	}
1223
1224	mControl.setNull();
1225
1226	if (mType == SessionType_WriteLock)
1227	{
1228	if (mClientTokenHolder)
1229	{
1230	delete mClientTokenHolder;
1231	mClientTokenHolder = NULL;
1232	}
1233
1234	if (!aFinalRelease && !aFromServer)
1235	{
1236	/*
1237	* Wait for the server to grab the semaphore and destroy the session
1238	* machine (allowing us to open a new session with the same machine
1239	* once this method returns)
1240	*/
1241	Assert(!!progress);
1242	if (progress)
1243	progress->WaitForCompletion(-1);
1244	}
1245	}
1246
1247	mState = SessionState_Unlocked;
1248	mType = SessionType_Null;
1249
1250	/* release the VirtualBox instance as the very last step */
1251	mVirtualBox.setNull();
1252
1253	LogFlowThisFuncLeave();
1254	return S_OK;
1255	}
1256
1257	/* vi: set tabstop=4 shiftwidth=4 expandtab: */

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/src/VBox/Main/src-client/SessionImpl.cpp@ 76690

Download in other formats: