VirtualBox

source: vbox/trunk/src/VBox/Frontends/VirtualBox/src/globals/UICloudNetworkingStuff.h@ 86738

Last change on this file since 86738 was 86738, checked in by vboxsync, 4 years ago

FE/Qt: bugref:9653: VirtualBox Manager: Extend UICloudNetworkingStuff namespace with stuff to acquire cloud provider by id.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 16.1 KB
Line 
1/* $Id: UICloudNetworkingStuff.h 86738 2020-10-28 15:53:54Z vboxsync $ */
2/** @file
3 * VBox Qt GUI - UICloudNetworkingStuff namespace declaration.
4 */
5
6/*
7 * Copyright (C) 2020 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#ifndef FEQT_INCLUDED_SRC_globals_UICloudNetworkingStuff_h
19#define FEQT_INCLUDED_SRC_globals_UICloudNetworkingStuff_h
20#ifndef RT_WITHOUT_PRAGMA_ONCE
21# pragma once
22#endif
23
24/* GUI includes: */
25#include "UILibraryDefs.h"
26
27/* COM includes: */
28#include "COMEnums.h"
29#include "CCloudClient.h"
30#include "CCloudMachine.h"
31#include "CCloudProfile.h"
32#include "CCloudProvider.h"
33#include "CCloudProviderManager.h"
34#include "CForm.h"
35
36/** Cloud networking stuff namespace. */
37namespace UICloudNetworkingStuff
38{
39 /** Acquires cloud provider manager,
40 * using @a pParent to show messages according to. */
41 SHARED_LIBRARY_STUFF CCloudProviderManager cloudProviderManager(QWidget *pParent = 0);
42 /** Acquires cloud provider manager,
43 * using @a strErrorMessage to store messages to. */
44 SHARED_LIBRARY_STUFF CCloudProviderManager cloudProviderManager(QString &strErrorMessage);
45 /** Acquires cloud provider specified by @a uProviderId,
46 * using @a pParent to show messages according to. */
47 SHARED_LIBRARY_STUFF CCloudProvider cloudProviderById(const QUuid &uProviderId,
48 QWidget *pParent = 0);
49 /** Acquires cloud provider specified by @a uProviderId,
50 * using @a strErrorMessage to store messages to. */
51 SHARED_LIBRARY_STUFF CCloudProvider cloudProviderById(const QUuid &uProviderId,
52 QString &strErrorMessage);
53 /** Acquires cloud provider specified by @a strProviderShortName,
54 * using @a pParent to show messages according to. */
55 SHARED_LIBRARY_STUFF CCloudProvider cloudProviderByShortName(const QString &strProviderShortName,
56 QWidget *pParent = 0);
57 /** Acquires cloud provider specified by @a strProviderShortName,
58 * using @a strErrorMessage to store messages to. */
59 SHARED_LIBRARY_STUFF CCloudProvider cloudProviderByShortName(const QString &strProviderShortName,
60 QString &strErrorMessage);
61 /** Acquires cloud profile specified by @a strProviderShortName and @a strProfileName,
62 * using @a pParent to show messages according to. */
63 SHARED_LIBRARY_STUFF CCloudProfile cloudProfileByName(const QString &strProviderShortName,
64 const QString &strProfileName,
65 QWidget *pParent = 0);
66 /** Acquires cloud profile specified by @a strProviderShortName and @a strProfileName,
67 * using @a strErrorMessage to store messages to. */
68 SHARED_LIBRARY_STUFF CCloudProfile cloudProfileByName(const QString &strProviderShortName,
69 const QString &strProfileName,
70 QString &strErrorMessage);
71 /** Acquires cloud client specified by @a strProviderShortName and @a strProfileName,
72 * using @a pParent to show messages according to. */
73 SHARED_LIBRARY_STUFF CCloudClient cloudClientByName(const QString &strProviderShortName,
74 const QString &strProfileName,
75 QWidget *pParent = 0);
76 /** Acquires cloud client specified by @a strProviderShortName and @a strProfileName,
77 * using @a strErrorMessage to store messages to. */
78 SHARED_LIBRARY_STUFF CCloudClient cloudClientByName(const QString &strProviderShortName,
79 const QString &strProfileName,
80 QString &strErrorMessage);
81 /** Acquires cloud machine specified by @a strProviderShortName, @a strProfileName and @a uMachineId,
82 * using @a pParent to show messages according to. */
83 SHARED_LIBRARY_STUFF CCloudMachine cloudMachineById(const QString &strProviderShortName,
84 const QString &strProfileName,
85 const QUuid &uMachineId,
86 QWidget *pParent = 0);
87 /** Acquires cloud machine specified by @a strProviderShortName, @a strProfileName and @a uMachineId,
88 * using @a strErrorMessage to store messages to. */
89 SHARED_LIBRARY_STUFF CCloudMachine cloudMachineById(const QString &strProviderShortName,
90 const QString &strProfileName,
91 const QUuid &uMachineId,
92 QString &strErrorMessage);
93
94 /** Acquires cloud providers, using @a pParent to show messages according to. */
95 SHARED_LIBRARY_STUFF QVector<CCloudProvider> listCloudProviders(QWidget *pParent = 0);
96 /** Acquires cloud providers, using @a strErrorMessage to store messages to. */
97 SHARED_LIBRARY_STUFF QVector<CCloudProvider> listCloudProviders(QString &strErrorMessage);
98
99 /** Acquires @a comCloudProvider ID as a @a uResult, using @a pParent to show messages according to. */
100 SHARED_LIBRARY_STUFF bool cloudProviderId(const CCloudProvider &comCloudProvider,
101 QUuid &uResult,
102 QWidget *pParent = 0);
103 /** Acquires @a comCloudProvider short name as a @a strResult, using @a pParent to show messages according to. */
104 SHARED_LIBRARY_STUFF bool cloudProviderShortName(const CCloudProvider &comCloudProvider,
105 QString &strResult,
106 QWidget *pParent = 0);
107 /** Acquires @a comCloudProvider name as a @a strResult, using @a pParent to show messages according to. */
108 SHARED_LIBRARY_STUFF bool cloudProviderName(const CCloudProvider &comCloudProvider,
109 QString &strResult,
110 QWidget *pParent = 0);
111
112 /** Acquires cloud profiles of certain @a comCloudProvider, using @a pParent to show messages according to. */
113 SHARED_LIBRARY_STUFF QVector<CCloudProfile> listCloudProfiles(CCloudProvider comCloudProvider,
114 QWidget *pParent = 0);
115 /** Acquires cloud profiles of certain @a comCloudProvider, using @a strErrorMessage to store messages to. */
116 SHARED_LIBRARY_STUFF QVector<CCloudProfile> listCloudProfiles(CCloudProvider comCloudProvider,
117 QString &strErrorMessage);
118
119 /** Acquires @a comCloudProfile name as a @a strResult, using @a pParent to show messages according to. */
120 SHARED_LIBRARY_STUFF bool cloudProfileName(const CCloudProfile &comCloudProfile,
121 QString &strResult,
122 QWidget *pParent = 0);
123 /** Acquires @a comCloudProfile properties as a @a keys/values using @a pParent to show messages according to. */
124 SHARED_LIBRARY_STUFF bool cloudProfileProperties(const CCloudProfile &comCloudProfile,
125 QVector<QString> &keys,
126 QVector<QString> &values,
127 QWidget *pParent = 0);
128
129 /** Acquires cloud machines of certain @a comCloudClient, using @a pParent to show messages according to. */
130 SHARED_LIBRARY_STUFF QVector<CCloudMachine> listCloudMachines(CCloudClient comCloudClient,
131 QWidget *pParent = 0);
132 /** Acquires cloud machines of certain @a comCloudClient, using @a strErrorMessage to store messages to. */
133 SHARED_LIBRARY_STUFF QVector<CCloudMachine> listCloudMachines(CCloudClient comCloudClient,
134 QString &strErrorMessage);
135 /** Acquires cloud machine stubs of certain @a comCloudClient, using @a pParent to show messages according to. */
136 SHARED_LIBRARY_STUFF QVector<CCloudMachine> listCloudMachineStubs(CCloudClient comCloudClient,
137 QWidget *pParent = 0);
138 /** Acquires cloud machine stubs of certain @a comCloudClient, using @a strErrorMessage to store messages to. */
139 SHARED_LIBRARY_STUFF QVector<CCloudMachine> listCloudMachineStubs(CCloudClient comCloudClient,
140 QString &strErrorMessage);
141
142 /** Acquires @a comCloudMachine ID as a @a uResult, using @a pParent to show messages according to. */
143 SHARED_LIBRARY_STUFF bool cloudMachineId(const CCloudMachine &comCloudMachine,
144 QUuid &uResult,
145 QWidget *pParent = 0);
146 /** Acquires @a comCloudMachine accessible state as a @a fResult, using @a pParent to show messages according to. */
147 SHARED_LIBRARY_STUFF bool cloudMachineAccessible(const CCloudMachine &comCloudMachine,
148 bool &fResult,
149 QWidget *pParent = 0);
150 /** Acquires @a comCloudMachine accessible error as a @a comResult, using @a pParent to show messages according to. */
151 SHARED_LIBRARY_STUFF bool cloudMachineAccessError(const CCloudMachine &comCloudMachine,
152 CVirtualBoxErrorInfo &comResult,
153 QWidget *pParent = 0);
154 /** Acquires @a comCloudMachine name as a @a strResult, using @a pParent to show messages according to. */
155 SHARED_LIBRARY_STUFF bool cloudMachineName(const CCloudMachine &comCloudMachine,
156 QString &strResult,
157 QWidget *pParent = 0);
158 /** Acquires @a comCloudMachine OS type ID as a @a strResult, using @a pParent to show messages according to. */
159 SHARED_LIBRARY_STUFF bool cloudMachineOSTypeId(const CCloudMachine &comCloudMachine,
160 QString &strResult,
161 QWidget *pParent = 0);
162 /** Acquires @a comCloudMachine state as a @a enmResult, using @a pParent to show messages according to. */
163 SHARED_LIBRARY_STUFF bool cloudMachineState(const CCloudMachine &comCloudMachine,
164 KCloudMachineState &enmResult,
165 QWidget *pParent = 0);
166 /** Acquires @a comCloudMachine console connection fingerprint as a @a strResult,
167 * using @a pParent to show messages according to. */
168 SHARED_LIBRARY_STUFF bool cloudMachineConsoleConnectionFingerprint(const CCloudMachine &comCloudMachine,
169 QString &strResult,
170 QWidget *pParent = 0);
171
172 /** Acquires @a comCloudMachine settings form as a @a comResult, using @a pParent to show messages according to.
173 * @note Be aware, this is a blocking function, corresponding progress dialog will be executed. */
174 SHARED_LIBRARY_STUFF bool cloudMachineSettingsForm(CCloudMachine comCloudMachine,
175 CForm &comResult,
176 QWidget *pParent = 0);
177 /** Acquires @a comCloudMachine settings form as a @a comResult, using @a strErrorMessage to store messages to.
178 * @note Be aware, this is a blocking function, it will hang for a time of progress being executed. */
179 SHARED_LIBRARY_STUFF bool cloudMachineSettingsForm(CCloudMachine comCloudMachine,
180 CForm &comResult,
181 QString &strErrorMessage);
182
183 /** Applies @a comCloudMachine @a comForm settings, using @a pParent to show messages according to.
184 * @note Be aware, this is a blocking function, corresponding progress dialog will be executed. */
185 SHARED_LIBRARY_STUFF bool applyCloudMachineSettingsForm(CCloudMachine comCloudMachine,
186 CForm comForm,
187 QWidget *pParent = 0);
188
189 /** Acquires instance map.
190 * @param comCloudClient Brings cloud client object.
191 * @param strErrorMessage Brings error message container.
192 * @param pWidget Brings parent widget to show messages according to,
193 * if no parent set, progress will be executed in blocking way. */
194 SHARED_LIBRARY_STUFF QMap<QString, QString> listInstances(const CCloudClient &comCloudClient,
195 QString &strErrorMessage,
196 QWidget *pParent = 0);
197 /** Acquires instance info as a map.
198 * @param comCloudClient Brings cloud client object.
199 * @param strId Brings cloud instance id.
200 * @param strErrorMessage Brings error message container.
201 * @param pWidget Brings parent widget to show messages according to,
202 * if no parent set, progress will be executed in blocking way. */
203 SHARED_LIBRARY_STUFF QMap<KVirtualSystemDescriptionType, QString> getInstanceInfo(const CCloudClient &comCloudClient,
204 const QString &strId,
205 QString &strErrorMessage,
206 QWidget *pParent = 0);
207 /** Acquires instance info of certain @a enmType as a string.
208 * @param comCloudClient Brings cloud client object.
209 * @param strId Brings cloud instance id.
210 * @param strErrorMessage Brings error message container.
211 * @param pWidget Brings parent widget to show messages according to,
212 * if no parent set, progress will be executed in blocking way. */
213 SHARED_LIBRARY_STUFF QString getInstanceInfo(KVirtualSystemDescriptionType enmType,
214 const CCloudClient &comCloudClient,
215 const QString &strId,
216 QString &strErrorMessage,
217 QWidget *pParent = 0);
218 /** Acquires image info as a map.
219 * @param comCloudClient Brings cloud client object.
220 * @param strId Brings cloud image id.
221 * @param strErrorMessage Brings error message container.
222 * @param pWidget Brings parent widget to show messages according to,
223 * if no parent set, progress will be executed in blocking way. */
224 SHARED_LIBRARY_STUFF QMap<QString, QString> getImageInfo(const CCloudClient &comCloudClient,
225 const QString &strId,
226 QString &strErrorMessage,
227 QWidget *pParent = 0);
228}
229
230/* Using across any module who included us: */
231using namespace UICloudNetworkingStuff;
232
233#endif /* !FEQT_INCLUDED_SRC_globals_UICloudNetworkingStuff_h */
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette