1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
/* $Id: SnapshotImpl.h $ */
/** @file
* VirtualBox COM class implementation
*/
/*
* Copyright (C) 2006-2020 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* you can redistribute it and/or modify it under the terms of the GNU
* General Public License (GPL) as published by the Free Software
* Foundation, in version 2 as it comes in the "COPYING" file of the
* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
*/
#ifndef MAIN_INCLUDED_SnapshotImpl_h
#define MAIN_INCLUDED_SnapshotImpl_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#include "SnapshotWrap.h"
class SnapshotMachine;
namespace settings
{
struct Snapshot;
}
class ATL_NO_VTABLE Snapshot :
public SnapshotWrap
{
public:
DECLARE_EMPTY_CTOR_DTOR(Snapshot)
HRESULT FinalConstruct();
void FinalRelease();
// public initializer/uninitializer only for internal purposes
HRESULT init(VirtualBox *aVirtualBox,
const Guid &aId,
const com::Utf8Str &aName,
const com::Utf8Str &aDescription,
const RTTIMESPEC &aTimeStamp,
SnapshotMachine *aMachine,
Snapshot *aParent);
void uninit();
void i_beginSnapshotDelete();
void i_deparent();
// public methods only for internal purposes
/**
* Override of the default locking class to be used for validating lock
* order with the standard member lock handle.
*/
virtual VBoxLockingClass getLockingClass() const
{
return LOCKCLASS_SNAPSHOTOBJECT;
}
const ComObjPtr<Snapshot>& i_getParent() const;
const ComObjPtr<Snapshot> i_getFirstChild() const;
const Utf8Str& i_getStateFilePath() const;
uint32_t i_getDepth();
ULONG i_getChildrenCount();
ULONG i_getAllChildrenCount();
ULONG i_getAllChildrenCountImpl();
const ComObjPtr<SnapshotMachine>& i_getSnapshotMachine() const;
Guid i_getId() const;
const Utf8Str& i_getName() const;
RTTIMESPEC i_getTimeStamp() const;
ComObjPtr<Snapshot> i_findChildOrSelf(IN_GUID aId);
ComObjPtr<Snapshot> i_findChildOrSelf(const com::Utf8Str &aName);
void i_updateSavedStatePaths(const Utf8Str &strOldPath,
const Utf8Str &strNewPath);
void i_updateSavedStatePathsImpl(const Utf8Str &strOldPath,
const Utf8Str &strNewPath);
bool i_sharesSavedStateFile(const Utf8Str &strPath,
Snapshot *pSnapshotToIgnore);
void i_updateNVRAMPaths(const Utf8Str &strOldPath,
const Utf8Str &strNewPath);
void i_updateNVRAMPathsImpl(const Utf8Str &strOldPath,
const Utf8Str &strNewPath);
HRESULT i_saveSnapshot(settings::Snapshot &data) const;
HRESULT i_saveSnapshotImpl(settings::Snapshot &data) const;
HRESULT i_saveSnapshotImplOne(settings::Snapshot &data) const;
HRESULT i_uninitOne(AutoWriteLock &writeLock,
CleanupMode_T cleanupMode,
MediaList &llMedia,
std::list<Utf8Str> &llFilenames);
HRESULT i_uninitRecursively(AutoWriteLock &writeLock,
CleanupMode_T cleanupMode,
MediaList &llMedia,
std::list<Utf8Str> &llFilenames);
private:
struct Data; // opaque, defined in SnapshotImpl.cpp
// wrapped ISnapshot properties
HRESULT getId(com::Guid &aId);
HRESULT getName(com::Utf8Str &aName);
HRESULT setName(const com::Utf8Str &aName);
HRESULT getDescription(com::Utf8Str &aDescription);
HRESULT setDescription(const com::Utf8Str &aDescription);
HRESULT getTimeStamp(LONG64 *aTimeStamp);
HRESULT getOnline(BOOL *aOnline);
HRESULT getMachine(ComPtr<IMachine> &aMachine);
HRESULT getParent(ComPtr<ISnapshot> &aParent);
HRESULT getChildren(std::vector<ComPtr<ISnapshot> > &aChildren);
// wrapped ISnapshot methods
HRESULT getChildrenCount(ULONG *aChildrenCount);
Data *m;
};
#endif /* !MAIN_INCLUDED_SnapshotImpl_h */
/* vi: set tabstop=4 shiftwidth=4 expandtab: */
|