Metodo CreateVirtualDisk della classe MSFT_StorageSubSystem
Crea un nuovo disco virtuale.
Sintassi
UInt32 CreateVirtualDisk(
[in] String FriendlyName,
[in] UInt16 Usage,
[in] String OtherUsageDescription,
[in, out] UInt64 Size,
[in] Boolean UseMaximumSize,
[in] UInt16 NumberOfDataCopies,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt64 Interleave,
[in] UInt16 ParityLayout,
[in] Boolean RequestNoSinglePointOfFailure,
[in] Boolean IsEnclosureAware,
[in] UInt16 ProvisioningType,
[in] Boolean RunAsJob,
[out] String CreatedVirtualDisk,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Parametri
FriendlyName [in]
Nome descrittivo per il disco virtuale.
I nomi descrittivi devono essere descrittivi, ma non devono essere univoci. Si noti che alcuni sottosistemi di archiviazione non consentono di impostare un nome descrittivo durante la creazione di dischi virtuali. Se un sottosistema non supporta questo problema, la creazione di dischi virtuali deve comunque avere esito positivo, tuttavia il disco potrebbe avere un nome diverso assegnato.
Questo parametro è obbligatorio e non può essere NULL.
Utilizzo [in]
Specifica l'utilizzo previsto per il disco virtuale.
È possibile specificare una descrizione predefinita o una descrizione personalizzata. Per specificare una descrizione predefinita, usare un valore diverso da Altro.
Per specificare una descrizione personalizzata, usare Other e specificare un valore non NULL per il parametro OtherUsageDescription .
Altro (1)
Senza restrizioni (2)
Riservato per ComputerSystem (server a blocchi) ( 3)
Riservato dai servizi di replica (4)
Riservato da Servizi di migrazione (5)
Origine replica locale (6)
Origine replica remota (7)
Destinazione replica locale (8)
Destinazione replica remota (9)
Origine replica locale o destinazione (10)
Origine di replica remota o destinazione (11)
Destinazione replica delta (12)
Componente elemento (13)
Riservato come collaboratore del pool (14)
Membro del volume composito (15)
Membro VirtualDisk composito (16)
Riservato per la sparing (17)
OtherUsageDescription [in]
Utilizzo specifico del fornitore per il nuovo disco virtuale. Questo parametro può essere specificato solo se il parametro Usage è impostato su Other.
Dimensioni [in, out]
Dimensioni desiderate, in byte, del disco virtuale. Si noti che alcuni sottosistemi di archiviazione arrotonderanno le dimensioni fino a un multiplo delle dimensioni dell'unità di allocazione.
Il sottosistema di archiviazione usa questo parametro solo se il parametro UseMaximumSize è FALSE o NULL.
Se il parametro UseMaximumSize è TRUE, questo parametro viene ignorato.
Questo parametro è obbligatorio e non può essere zero.
UseMaximumSize [in]
Se TRUE, usare le dimensioni massime disponibili per creare il disco virtuale.
Questo parametro non può essere usato insieme al parametro Size .
NumberOfDataCopies [in]
Numero di copie dei dati complete da mantenere per questo disco virtuale.
PhysicalDiskRedundancy [in]
Numero di errori del disco fisico che il disco virtuale deve essere in grado di resistere prima che si verifichi la perdita di dati.
NumberOfColumns [in]
Numero di dischi fisici sottostanti in cui è necessario eseguire lo striping dei dati. Questo parametro è obbligatorio.
Interleave [in]
Numero di byte che devono essere per una strip in impostazioni comuni di resilienza basata su striping. La striscia viene definita come dimensione della parte di una striscia che si trova su un disco fisico. Pertanto, l'interleave * NumberOfColumns restituirà le dimensioni di una striscia. Questo parametro è obbligatorio.
ParityLayout [in]
Se si desidera un'impostazione di resilienza basata sulla parità, impostare questo parametro su uno dei valori seguenti.
Se l'impostazione di resilienza desiderata non è basata sulla parità, questa proprietà deve essere NULL.
Parità non ruotata (1)
Parità ruotata (2)
RequestNoSinglePointOfFailure [in]
Impostare su TRUE per richiedere nessun singolo punto di errore.
IsEnclosureAware [in]
Comportamento di allocazione per questo disco virtuale. I dischi virtuali con riconoscimento dell'chassis selezionano in modo intelligente i dischi fisici da usare per la ridondanza. Se TRUE, il disco virtuale tenterà di usare dischi fisici da contenitori diversi per bilanciare la tolleranza di errore tra due o più enclosure fisici.
ProvisioningType [in]
Tipo di provisioning per il disco virtuale.
Sottile (1)
Correzione (2)
RunAsJob [in]
Se TRUE, questo metodo usa il parametro CreateStorageJob 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 controllati - Processo avviato.
Nota
Anche se RunAsJob è TRUE, questo metodo può comunque restituire un risultato se è stato completato in tempo sufficiente.
Se FALSE o NULL, questo metodo seguirà il comportamento asincrono WMI predefinito, come determinato dal metodo del client per la chiamata. In altre parole, è sincrono a meno che non sia richiesto altrimenti.
CreateVirtualDisk [out]
Se il disco virtuale viene creato correttamente, questo parametro riceve una stringa contenente un oggetto MSFT_VirtualDisk incorporato.
CreateStorageJob [out]
Se RunAsJob è impostato su TRUE e questo metodo richiede molto tempo per l'esecuzione, questo parametro riceve un riferimento all'oggetto processo di archiviazione usato per tenere traccia dell'operazione a esecuzione prolungata.
ExtendedStatus [out]
Stringa che contiene un oggetto MSFT_StorageExtendedStatus incorporato.
Questo parametro consente al provider di archiviazione di restituire informazioni di errore estese (specifiche dell'implementazione).
Valore restituito
Successo (0)
Non supportato (1)
Errore non specificato (2)
Timeout (3)
Errore (4)
Parametro non valido (5)
Parametri del metodo controllati - Processo avviato (4096)
Dimensioni non supportate (4097)
Spazio libero non sufficiente (40000)
Accesso negato (40001)
Non sono disponibili risorse sufficienti per completare l'operazione. (40002)
Cache non aggiornata (40003)
È necessario specificare una dimensione utilizzando il parametro Size o UseMaximumSize. È possibile specificare solo uno di questi parametri alla volta. (40005)
Impossibile connettersi al provider di archiviazione. (46000)
Il provider di archiviazione non può connettersi al sottosistema di archiviazione. (46001)
Non sono stati trovati pool di archiviazione che supportano questa configurazione del disco virtuale. (47000)
Il valore di NoSinglePointOfFailure non è supportato. (49001)
Il valore di PhysicalDiskRedundancy non rientra nell'intervallo di valori supportato. (49002)
Il valore per NumberOfDataCopies non rientra nell'intervallo di valori supportato. (49003)
Il valore di ParityLayout non rientra nell'intervallo di valori supportato. (49004)
Il valore di Interleave non rientra nell'intervallo di valori supportato. (49005)
Il valore per NumberOfColumns non rientra nell'intervallo di valori supportato. (49006)
Commenti
Questo metodo viene in genere usato quando si verifica una delle condizioni seguenti:
- I pool di archiviazione del sottosistema di archiviazione non consentono direttamente la creazione di dischi virtuali.
- Il sottosistema di archiviazione non supporta i pool di archiviazione.
I provider di gestione archiviazione possono anche scegliere di implementare questo metodo per selezionare "in modo intelligente" un pool di archiviazione per l'utente. Se questo metodo è supportato, la proprietà SupportsAutomaticStoragePoolSelection del sottosistema deve essere impostata su TRUE.
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 |
| MOF | Storagewmi.mof |