Metodo CreateSnapshot della classe MSFT_VirtualDisk
Crea un nuovo disco virtuale che rappresenta una copia shadow del disco virtuale esistente.
Sintassi
UInt32 CreateSnapshot(
[in] String FriendlyName,
[in] String TargetStoragePoolName,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String CreatedVirtualDisk,
[out] String ExtendedStatus
);
Parametri
FriendlyName [in]
Nome desiderato del disco virtuale della copia shadow.
Questo parametro è obbligatorio e non può essere NULL.
TargetStoragePoolName [in]
Pool di archiviazione da usare per contenere lo snapshot creato. Se questo parametro non è impostato, per impostazione predefinita questo metodo usa lo stesso pool di archiviazione che contiene il disco virtuale di origine.
RunAsJob [in]
Se TRUE, questo metodo usa il parametro CreatedStorageJob quando la richiesta richiede molto tempo al servizio. Se è stato creato un processo di archiviazione per tenere traccia dell'operazione, questo metodo restituirà i parametri del metodo checked - Job Started.
Nota
Anche se RunAsJob è TRUE, questo metodo può comunque restituire un risultato se è terminato in tempo sufficiente.
Se FALSE o NULL, questo metodo seguirà il comportamento asincrono WMI predefinito determinato dal metodo del client per la chiamata. In altre parole, è sincrono, a meno che non venga richiesto diversamente.
CreatedStorageJob [out]
Se RunAsJob è impostato su TRUE e l'esecuzione di questo metodo richiede molto tempo, questo parametro riceve un riferimento all'oggetto processo di archiviazione utilizzato per tenere traccia dell'operazione a esecuzione prolungata.
CreatedVirtualDisk [out]
Se il disco virtuale viene creato correttamente, questo parametro riceve una stringa contenente un oggetto MSFT_VirtualDisk incorporato.
ExtendedStatus [out]
Stringa contenente un oggetto MSFT_StorageExtendedStatus incorporato.
Questo parametro consente al provider di archiviazione di restituire informazioni di errore estese (specifiche dell'implementazione).
Valore restituito
Operazione riuscita (0)
Non supportato (1)
Errore non specificato (2)
Timeout (3)
Non riuscito (4)
Parametro non valido (5)
Parametri del metodo controllati - Processo avviato (4096)
Spazio disponibile insufficiente (40000)
Accesso negato (40001)
Non sono disponibili risorse sufficienti per completare l'operazione. (40002)
Cache non aggiornata (40003)
Impossibile connettersi al provider di archiviazione. (46000)
Il provider di archiviazione non può connettersi al sottosistema di archiviazione. (46001)
Questa operazione non è supportata nei pool di archiviazione primordiali. (48000)
Il pool di archiviazione è riservato solo per utilizzo speciale. (48001)
Impossibile trovare il pool di archiviazione specificato. (48005)
Il pool di archiviazione non è riuscito a completare l'operazione perché lo stato di integrità o operativo non lo consente. (48006)
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Spazio dei nomi | Root\Microsoft\Windows\Storage |
| Intestazione | Dbdaoint.h |
| MOF | Storagewmi.mof |