CreateSnapshot-Methode der MSFT_VirtualDisk-Klasse
Erstellt einen neuen virtuellen Datenträger, der eine Schattenkopie des vorhandenen virtuellen Datenträgers ist.
Syntax
UInt32 CreateSnapshot(
[in] String FriendlyName,
[in] String TargetStoragePoolName,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String CreatedVirtualDisk,
[out] String ExtendedStatus
);
Parameter
FriendlyName [in]
Der gewünschte Name des virtuellen Schattenkopiedatenträgers.
Dieser Parameter ist erforderlich und darf nicht NULL sein.
TargetStoragePoolName [in]
Der Speicherpool, der zum Speichern des erstellten Momentaufnahme verwendet werden soll. Wenn dieser Parameter nicht festgelegt ist, verwendet diese Methode standardmäßig denselben Speicherpool, der den virtuellen Quelldatenträger enthält.
RunAsJob [in]
Bei TRUE verwendet diese Methode den Parameter CreatedStorageJob , wenn die Anforderung lange dauert. Wenn ein Speicherauftrag zum Nachverfolgen des Vorgangs erstellt wurde, gibt diese Methode Methodenparameter Überprüft – Auftrag gestartet zurück.
Hinweis
Selbst wenn RunAsJobTRUE ist, kann diese Methode trotzdem ein Ergebnis zurückgeben, wenn sie in ausreichender Zeit abgeschlossen ist.
Wenn FALSE oder NULL, folgt diese Methode dem standardmäßigen asynchronen WMI-Verhalten, das von der Clientmethode für den Aufruf bestimmt wird. Mit anderen Worten, es ist synchron, sofern nicht anders angefordert.
CreatedStorageJob [out]
Wenn RunAsJob auf TRUE festgelegt ist und die Ausführung dieser Methode sehr lange dauert, empfängt dieser Parameter einen Verweis auf das Speicherauftragsobjekt, das zum Nachverfolgen des lang andauernden Vorgangs verwendet wird.
CreatedVirtualDisk [out]
Wenn der virtuelle Datenträger erfolgreich erstellt wurde, empfängt dieser Parameter eine Zeichenfolge, die ein eingebettetes MSFT_VirtualDisk -Objekt enthält.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Mit diesem Parameter kann der Speicheranbieter erweiterte (implementierungsspezifische) Fehlerinformationen zurückgeben.
Rückgabewert
Erfolg (0)
Nicht unterstützt (1)
Nicht angegebener Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Methodenparameter überprüft – Auftrag gestartet (4096)
Nicht genügend freier Speicherplatz (40000)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Cache veraltet (40003)
Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)
Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)
Dieser Vorgang wird für ursprüngliche Speicherpools nicht unterstützt. (48000)
Der Speicherpool ist nur für spezielle Verwendungen reserviert. (48001)
Der angegebene Speicherpool konnte nicht gefunden werden. (48005)
Der Speicherpool konnte den Vorgang nicht abschließen, da seine Integrität oder betriebliche status dies nicht zulässt. (48006)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Stamm\Microsoft\Windows\Storage |
| Header | Dbdaoint.h |
| MOF | Storagewmi.mof |