SessionImpl.cpp@ 75441

Last change on this file since 75441 was 75361, checked in by vboxsync, 6 years ago
Recording/Main: Renamed the IRecord* interfaces again to IRecording* to make it more standardized.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 38.0 KB

Line
1	/* $Id: SessionImpl.cpp 75361 2018-11-09 12:56:40Z vboxsync $ */
2	/** @file
3	* VBox Client Session COM Class implementation in VBoxC.
4	*/
5
6	/*
7	* Copyright (C) 2006-2017 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 <VBox/err.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()
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();
738	#else
739	return S_OK;
740	#endif
741	}
742
743	HRESULT Session::onUSBControllerChange()
744	{
745	LogFlowThisFunc(("\n"));
746
747	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
748	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
749	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
750	#ifndef VBOX_COM_INPROC_API_CLIENT
751	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
752
753	return mConsole->i_onUSBControllerChange();
754	#else
755	return S_OK;
756	#endif
757	}
758
759	HRESULT Session::onSharedFolderChange(BOOL aGlobal)
760	{
761	LogFlowThisFunc(("\n"));
762
763	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
764	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
765	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
766	#ifndef VBOX_COM_INPROC_API_CLIENT
767	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
768
769	return mConsole->i_onSharedFolderChange(aGlobal);
770	#else
771	RT_NOREF(aGlobal);
772	return S_OK;
773	#endif
774	}
775
776	HRESULT Session::onClipboardModeChange(ClipboardMode_T aClipboardMode)
777	{
778	LogFlowThisFunc(("\n"));
779
780	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
781	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
782	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
783	#ifndef VBOX_COM_INPROC_API_CLIENT
784	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
785
786	return mConsole->i_onClipboardModeChange(aClipboardMode);
787	#else
788	RT_NOREF(aClipboardMode);
789	return S_OK;
790	#endif
791	}
792
793	HRESULT Session::onDnDModeChange(DnDMode_T aDndMode)
794	{
795	LogFlowThisFunc(("\n"));
796
797	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
798	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
799	#ifndef VBOX_COM_INPROC_API_CLIENT
800	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
801	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
802
803	return mConsole->i_onDnDModeChange(aDndMode);
804	#else
805	RT_NOREF(aDndMode);
806	return S_OK;
807	#endif
808	}
809
810	HRESULT Session::onUSBDeviceAttach(const ComPtr<IUSBDevice> &aDevice,
811	const ComPtr<IVirtualBoxErrorInfo> &aError,
812	ULONG aMaskedInterfaces,
813	const com::Utf8Str &aCaptureFilename)
814	{
815	LogFlowThisFunc(("\n"));
816
817	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
818	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
819	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
820	#ifndef VBOX_COM_INPROC_API_CLIENT
821	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
822
823	return mConsole->i_onUSBDeviceAttach(aDevice, aError, aMaskedInterfaces, aCaptureFilename);
824	#else
825	RT_NOREF(aDevice, aError, aMaskedInterfaces, aCaptureFilename);
826	return S_OK;
827	#endif
828	}
829
830	HRESULT Session::onUSBDeviceDetach(const com::Guid &aId,
831	const ComPtr<IVirtualBoxErrorInfo> &aError)
832	{
833	LogFlowThisFunc(("\n"));
834
835	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
836	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
837	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
838	#ifndef VBOX_COM_INPROC_API_CLIENT
839	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
840
841	return mConsole->i_onUSBDeviceDetach(aId.toUtf16().raw(), aError);
842	#else
843	RT_NOREF(aId, aError);
844	return S_OK;
845	#endif
846	}
847
848	HRESULT Session::onShowWindow(BOOL aCheck, BOOL aCanShow, LONG64 aWinId)
849	{
850	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
851
852	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
853	#ifndef VBOX_COM_INPROC_API_CLIENT
854	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
855	#endif
856
857	if (mState != SessionState_Locked)
858	{
859	/* the call from Machine issued when the session is open can arrive
860	* after the session starts closing or gets closed. Note that when
861	* aCheck is false, we return E_FAIL to indicate that aWinId we return
862	* is not valid */
863	*aCanShow = FALSE;
864	*aWinId = 0;
865	return aCheck ? S_OK : E_FAIL;
866	}
867
868	#ifndef VBOX_COM_INPROC_API_CLIENT
869	return mConsole->i_onShowWindow(aCheck, aCanShow, aWinId);
870	#else
871	return S_OK;
872	#endif
873	}
874
875	HRESULT Session::onBandwidthGroupChange(const ComPtr<IBandwidthGroup> &aBandwidthGroup)
876	{
877	LogFlowThisFunc(("\n"));
878
879	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
880	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
881	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
882	#ifndef VBOX_COM_INPROC_API_CLIENT
883	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
884
885	return mConsole->i_onBandwidthGroupChange(aBandwidthGroup);
886	#else
887	RT_NOREF(aBandwidthGroup);
888	return S_OK;
889	#endif
890	}
891
892	HRESULT Session::onStorageDeviceChange(const ComPtr<IMediumAttachment> &aMediumAttachment, BOOL aRemove, BOOL aSilent)
893	{
894	LogFlowThisFunc(("\n"));
895
896	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
897	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
898	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
899	#ifndef VBOX_COM_INPROC_API_CLIENT
900	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
901
902	return mConsole->i_onStorageDeviceChange(aMediumAttachment, aRemove, aSilent);
903	#else
904	RT_NOREF(aMediumAttachment, aRemove, aSilent);
905	return S_OK;
906	#endif
907	}
908
909	HRESULT Session::accessGuestProperty(const com::Utf8Str &aName, const com::Utf8Str &aValue, const com::Utf8Str &aFlags,
910	ULONG aAccessMode, com::Utf8Str &aRetValue, LONG64 *aRetTimestamp, com::Utf8Str &aRetFlags)
911	{
912	#ifdef VBOX_WITH_GUEST_PROPS
913	# ifndef VBOX_COM_INPROC_API_CLIENT
914	if (mState != SessionState_Locked)
915	return setError(VBOX_E_INVALID_VM_STATE,
916	tr("Machine is not locked by session (session state: %s)."),
917	Global::stringifySessionState(mState));
918	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
919	if (aName.isEmpty())
920	return E_INVALIDARG;
921	if (aAccessMode == 0 && !RT_VALID_PTR(aRetTimestamp))
922	return E_POINTER;
923
924	/* If this session is not in a VM process fend off the call. The caller
925	* handles this correctly, by doing the operation in VBoxSVC. */
926	if (!mConsole)
927	return E_ACCESSDENIED;
928
929	HRESULT hr;
930	if (aAccessMode == 2)
931	hr = mConsole->i_deleteGuestProperty(aName);
932	else if (aAccessMode == 1)
933	hr = mConsole->i_setGuestProperty(aName, aValue, aFlags);
934	else if (aAccessMode == 0)
935	hr = mConsole->i_getGuestProperty(aName, &aRetValue, aRetTimestamp, &aRetFlags);
936	else
937	hr = E_INVALIDARG;
938
939	return hr;
940	# else /* VBOX_COM_INPROC_API_CLIENT */
941	/** @todo This is nonsense, non-VM API users shouldn't need to deal with this
942	* method call, VBoxSVC should be clever enough to see that the
943	* session doesn't have a console! */
944	RT_NOREF(aName, aValue, aFlags, aAccessMode, aRetValue, aRetTimestamp, aRetFlags);
945	return E_ACCESSDENIED;
946	# endif /* VBOX_COM_INPROC_API_CLIENT */
947
948	#else /* VBOX_WITH_GUEST_PROPS */
949	ReturnComNotImplemented();
950	#endif /* VBOX_WITH_GUEST_PROPS */
951	}
952
953	HRESULT Session::enumerateGuestProperties(const com::Utf8Str &aPatterns,
954	std::vector<com::Utf8Str> &aKeys,
955	std::vector<com::Utf8Str> &aValues,
956	std::vector<LONG64> &aTimestamps,
957	std::vector<com::Utf8Str> &aFlags)
958	{
959	#if defined(VBOX_WITH_GUEST_PROPS) && !defined(VBOX_COM_INPROC_API_CLIENT)
960	if (mState != SessionState_Locked)
961	return setError(VBOX_E_INVALID_VM_STATE,
962	tr("Machine is not locked by session (session state: %s)."),
963	Global::stringifySessionState(mState));
964	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
965
966	/* If this session is not in a VM process fend off the call. The caller
967	* handles this correctly, by doing the operation in VBoxSVC. */
968	if (!mConsole)
969	return E_ACCESSDENIED;
970
971	return mConsole->i_enumerateGuestProperties(aPatterns, aKeys, aValues, aTimestamps, aFlags);
972
973	#else /* VBOX_WITH_GUEST_PROPS not defined */
974	RT_NOREF(aPatterns, aKeys, aValues, aTimestamps, aFlags);
975	ReturnComNotImplemented();
976	#endif /* VBOX_WITH_GUEST_PROPS not defined */
977	}
978
979	HRESULT Session::onlineMergeMedium(const ComPtr<IMediumAttachment> &aMediumAttachment, ULONG aSourceIdx,
980	ULONG aTargetIdx, const ComPtr<IProgress> &aProgress)
981	{
982	if (mState != SessionState_Locked)
983	return setError(VBOX_E_INVALID_VM_STATE,
984	tr("Machine is not locked by session (session state: %s)."),
985	Global::stringifySessionState(mState));
986	#ifndef VBOX_COM_INPROC_API_CLIENT
987	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
988	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
989
990	return mConsole->i_onlineMergeMedium(aMediumAttachment,
991	aSourceIdx, aTargetIdx,
992	aProgress);
993	#else
994	RT_NOREF(aMediumAttachment, aSourceIdx, aTargetIdx, aProgress);
995	AssertFailed();
996	return E_NOTIMPL;
997	#endif
998	}
999
1000	HRESULT Session::reconfigureMediumAttachments(const std::vector<ComPtr<IMediumAttachment> > &aAttachments)
1001	{
1002	if (mState != SessionState_Locked)
1003	return setError(VBOX_E_INVALID_VM_STATE,
1004	tr("Machine is not locked by session (session state: %s)."),
1005	Global::stringifySessionState(mState));
1006	#ifndef VBOX_COM_INPROC_API_CLIENT
1007	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1008	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1009
1010	return mConsole->i_reconfigureMediumAttachments(aAttachments);
1011	#else
1012	RT_NOREF(aAttachments);
1013	AssertFailed();
1014	return E_NOTIMPL;
1015	#endif
1016	}
1017
1018	HRESULT Session::enableVMMStatistics(BOOL aEnable)
1019	{
1020	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1021	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1022	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1023	#ifndef VBOX_COM_INPROC_API_CLIENT
1024	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1025
1026	mConsole->i_enableVMMStatistics(aEnable);
1027
1028	return S_OK;
1029	#else
1030	RT_NOREF(aEnable);
1031	AssertFailed();
1032	return E_NOTIMPL;
1033	#endif
1034	}
1035
1036	HRESULT Session::pauseWithReason(Reason_T aReason)
1037	{
1038	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1039	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1040	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1041	#ifndef VBOX_COM_INPROC_API_CLIENT
1042	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1043
1044	return mConsole->i_pause(aReason);
1045	#else
1046	RT_NOREF(aReason);
1047	AssertFailed();
1048	return E_NOTIMPL;
1049	#endif
1050	}
1051
1052	HRESULT Session::resumeWithReason(Reason_T aReason)
1053	{
1054	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1055	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1056	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1057	#ifndef VBOX_COM_INPROC_API_CLIENT
1058	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1059
1060	AutoWriteLock dummyLock(mConsole COMMA_LOCKVAL_SRC_POS);
1061	return mConsole->i_resume(aReason, dummyLock);
1062	#else
1063	RT_NOREF(aReason);
1064	AssertFailed();
1065	return E_NOTIMPL;
1066	#endif
1067	}
1068
1069	HRESULT Session::saveStateWithReason(Reason_T aReason,
1070	const ComPtr<IProgress> &aProgress,
1071	const ComPtr<ISnapshot> &aSnapshot,
1072	const Utf8Str &aStateFilePath,
1073	BOOL aPauseVM, BOOL *aLeftPaused)
1074	{
1075	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1076	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1077	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1078	#ifndef VBOX_COM_INPROC_API_CLIENT
1079	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1080
1081	bool fLeftPaused = false;
1082	HRESULT rc = mConsole->i_saveState(aReason, aProgress, aSnapshot, aStateFilePath, !!aPauseVM, fLeftPaused);
1083	if (aLeftPaused)
1084	*aLeftPaused = fLeftPaused;
1085	return rc;
1086	#else
1087	RT_NOREF(aReason, aProgress, aSnapshot, aStateFilePath, aPauseVM, aLeftPaused);
1088	AssertFailed();
1089	return E_NOTIMPL;
1090	#endif
1091	}
1092
1093	HRESULT Session::cancelSaveStateWithReason()
1094	{
1095	AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS);
1096	AssertReturn(mState == SessionState_Locked, VBOX_E_INVALID_VM_STATE);
1097	AssertReturn(mType == SessionType_WriteLock, VBOX_E_INVALID_OBJECT_STATE);
1098	#ifndef VBOX_COM_INPROC_API_CLIENT
1099	AssertReturn(mConsole, VBOX_E_INVALID_OBJECT_STATE);
1100
1101	return mConsole->i_cancelSaveState();
1102	#else
1103	AssertFailed();
1104	return E_NOTIMPL;
1105	#endif
1106	}
1107
1108	// private methods
1109	///////////////////////////////////////////////////////////////////////////////
1110
1111	/**
1112	* Unlocks a machine associated with the current session.
1113	*
1114	* @param aFinalRelease called as a result of FinalRelease()
1115	* @param aFromServer called as a result of Uninitialize()
1116	* @param aLockW The write lock this object is protected with.
1117	* Must be acquired already and will be released
1118	* and later reacquired during the unlocking.
1119	*
1120	* @note To be called only from #uninit(), ISession::UnlockMachine() or
1121	* ISession::Uninitialize().
1122	*/
1123	HRESULT Session::i_unlockMachine(bool aFinalRelease, bool aFromServer, AutoWriteLock &aLockW)
1124	{
1125	LogFlowThisFuncEnter();
1126	LogFlowThisFunc(("aFinalRelease=%d, isFromServer=%d\n",
1127	aFinalRelease, aFromServer));
1128
1129	LogFlowThisFunc(("mState=%s, mType=%d\n", Global::stringifySessionState(mState), mType));
1130
1131	Assert(aLockW.isWriteLockOnCurrentThread());
1132
1133	if (mState != SessionState_Locked)
1134	{
1135	Assert(mState == SessionState_Spawning);
1136
1137	/* The session object is going to be uninitialized before it has been
1138	* assigned a direct console of the machine the client requested to open
1139	* a remote session to using IVirtualBox:: openRemoteSession(). It is OK
1140	* only if this close request comes from the server (for example, it
1141	* detected that the VM process it started terminated before opening a
1142	* direct session). Otherwise, it means that the client is too fast and
1143	* trying to close the session before waiting for the progress object it
1144	* got from IVirtualBox:: openRemoteSession() to complete, so assert. */
1145	Assert(aFromServer);
1146
1147	mState = SessionState_Unlocked;
1148	mType = SessionType_Null;
1149
1150	Assert(!mClientTokenHolder);
1151
1152	LogFlowThisFuncLeave();
1153	return S_OK;
1154	}
1155
1156	/* go to the closing state */
1157	mState = SessionState_Unlocking;
1158
1159	if (mType == SessionType_WriteLock)
1160	{
1161	#ifndef VBOX_COM_INPROC_API_CLIENT
1162	if (!mConsole.isNull())
1163	{
1164	mConsole->uninit();
1165	mConsole.setNull();
1166	}
1167	#else
1168	mRemoteMachine.setNull();
1169	#endif
1170	}
1171	else
1172	{
1173	mRemoteMachine.setNull();
1174	mRemoteConsole.setNull();
1175	}
1176
1177	ComPtr<IProgress> progress;
1178
1179	if (!aFinalRelease && !aFromServer)
1180	{
1181	/*
1182	* We trigger OnSessionEnd() only when the session closes itself using
1183	* Close(). Note that if isFinalRelease = TRUE here, this means that
1184	* the client process has already initialized the termination procedure
1185	* without issuing Close() and the IPC channel is no more operational --
1186	* so we cannot call the server's method (it will definitely fail). The
1187	* server will instead simply detect the abnormal client death (since
1188	* OnSessionEnd() is not called) and reset the machine state to Aborted.
1189	*/
1190
1191	/*
1192	* while waiting for OnSessionEnd() to complete one of our methods
1193	* can be called by the server (for example, Uninitialize(), if the
1194	* direct session has initiated a closure just a bit before us) so
1195	* we need to release the lock to avoid deadlocks. The state is already
1196	* SessionState_Closing here, so it's safe.
1197	*/
1198	aLockW.release();
1199
1200	Assert(!aLockW.isWriteLockOnCurrentThread());
1201
1202	LogFlowThisFunc(("Calling mControl->OnSessionEnd()...\n"));
1203	HRESULT rc = mControl->OnSessionEnd(this, progress.asOutParam());
1204	LogFlowThisFunc(("mControl->OnSessionEnd()=%08X\n", rc));
1205
1206	aLockW.acquire();
1207
1208	/*
1209	* If we get E_UNEXPECTED this means that the direct session has already
1210	* been closed, we're just too late with our notification and nothing more
1211	*
1212	* bird: Seems E_ACCESSDENIED is what gets returned these days; see
1213	* ObjectState::addCaller.
1214	*/
1215	if (mType != SessionType_WriteLock && (rc == E_UNEXPECTED \|\| rc == E_ACCESSDENIED))
1216	rc = S_OK;
1217
1218	#if !defined(DEBUG_bird) && !defined(DEBUG_andy) /* I don't want clients crashing on me just because VBoxSVC went belly up. */
1219	AssertComRC(rc);
1220	#endif
1221	}
1222
1223	mControl.setNull();
1224
1225	if (mType == SessionType_WriteLock)
1226	{
1227	if (mClientTokenHolder)
1228	{
1229	delete mClientTokenHolder;
1230	mClientTokenHolder = NULL;
1231	}
1232
1233	if (!aFinalRelease && !aFromServer)
1234	{
1235	/*
1236	* Wait for the server to grab the semaphore and destroy the session
1237	* machine (allowing us to open a new session with the same machine
1238	* once this method returns)
1239	*/
1240	Assert(!!progress);
1241	if (progress)
1242	progress->WaitForCompletion(-1);
1243	}
1244	}
1245
1246	mState = SessionState_Unlocked;
1247	mType = SessionType_Null;
1248
1249	/* release the VirtualBox instance as the very last step */
1250	mVirtualBox.setNull();
1251
1252	LogFlowThisFuncLeave();
1253	return S_OK;
1254	}
1255
1256	/* 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@ 75441

Download in other formats: