CreateVirtualDisk-Methode der MSFT_StorageSubSystem-Klasse
Erstellt einen neuen virtuellen Datenträger.
Syntax
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
);
Parameter
FriendlyName [in]
Der Anzeigename für den virtuellen Datenträger.
Anzeigenamen sollten beschreibend sein, müssen aber nicht eindeutig sein. Beachten Sie, dass einige Speichersubsysteme das Festlegen eines Anzeigenamens während der Erstellung virtueller Datenträger nicht zulassen. Wenn dies von einem Subsystem nicht unterstützt wird, sollte die Erstellung des virtuellen Datenträgers weiterhin erfolgreich sein. Dem Datenträger ist jedoch möglicherweise ein anderer Name zugewiesen.
Dieser Parameter ist erforderlich und darf nicht NULL sein.
Verwendung [in]
Gibt die beabsichtigte Verwendung für den virtuellen Datenträger an.
Sie können eine vordefinierte Beschreibung oder eine benutzerdefinierte Beschreibung angeben. Verwenden Sie zum Angeben einer vordefinierten Beschreibung einen anderen Wert als Other.
Um eine benutzerdefinierte Beschreibung anzugeben, verwenden Sie Other , und geben Sie einen Wert ungleich NULL für den OtherUsageDescription-Parameter an .
Sonstiges (1)
Uneingeschränkt (2)
Reserviert für ComputerSystem (blockserver) (3)
Reserviert durch Replikationsdienste (4)
Reserviert von Migration Services (5)
Quelle des lokalen Replikats (6)
Remotereplikatquelle (7)
Ziel des lokalen Replikats (8)
Remotereplikatziel (9)
Quelle oder Ziel des lokalen Replikats (10)
Remotereplikatquelle oder -ziel (11)
Deltareplikatziel (12)
Elementkomponente (13)
Reserviert als Poolmitwirkender (14)
Zusammengesetztes Volumeelement (15)
Zusammengesetztes virtuelles Datenträgerelement (16)
Reserviert für Sparing (17)
OtherUsageDescription [in]
Eine herstellerspezifische Verwendung für den neuen virtuellen Datenträger. Dieser Parameter kann nur angegeben werden, wenn der Usage-Parameter auf Other festgelegt ist.
Größe [ein, ausgehend]
Die gewünschte Größe des virtuellen Datenträgers in Byte. Beachten Sie, dass einige Speichersubsysteme die Größe auf ein Vielfaches ihrer Zuordnungseinheitengröße auf- oder herunterrunden.
Das Speichersubsystem verwendet diesen Parameter nur, wenn der UseMaximumSize-ParameterFALSE oder NULL ist.
Wenn der UseMaximumSize-ParameterTRUE ist, wird dieser Parameter ignoriert.
Dieser Parameter ist erforderlich und darf nicht 0 (null) sein.
UseMaximumSize [in]
Wenn TRUE, verwenden Sie die maximal verfügbare Größe, um den virtuellen Datenträger zu erstellen.
Dieser Parameter kann nicht zusammen mit dem Parameter Size verwendet werden.
NumberOfDataCopies [in]
Die Anzahl der vollständigen Datenkopien, die für diesen virtuellen Datenträger verwaltet werden sollen.
PhysicalDiskRedundancy [in]
Die Anzahl von Physischen Datenträgerfehlern, denen der virtuelle Datenträger standhalten sollte, bevor ein Datenverlust auftritt.
NumberOfColumns [in]
Die Anzahl der zugrunde liegenden physischen Datenträger, über die Daten gestreift werden sollen. Dieser Parameter ist erforderlich.
Interleave [in]
Die Anzahl der Bytes, die für einen Strip in gängigen Resilienzeinstellungen auf Stripingbasis verwendet werden sollen. Der Strip ist definiert als die Größe des Teils eines Stripes, der sich auf einem physischen Datenträger befindet. Daher ergibt Interleave * NumberOfColumns die Größe eines Streifens. Dieser Parameter ist erforderlich.
ParityLayout [in]
Wenn eine paritätsbasierte Resilienzeinstellung gewünscht wird, legen Sie diesen Parameter auf einen der folgenden Werte fest.
Wenn die gewünschte Resilienzeinstellung nicht paritätsbasiert ist, muss diese Eigenschaft NULL sein.
Nicht gedrehte Parität (1)
Gedrehte Parität (2)
RequestNoSinglePointOfFailure [in]
Legen Sie auf TRUE fest, um keinen Single Point of Failure anzufordern.
IsEnclosureAware [in]
Das Zuordnungsverhalten für diesen virtuellen Datenträger. Bei gehäusefähigen virtuellen Datenträgern werden die physischen Datenträger, die für ihre Redundanz verwendet werden sollen, intelligent ausgewählt. Bei TRUE versucht der virtuelle Datenträger, physische Datenträger aus verschiedenen Gehäusen zu verwenden, um die Fehlertoleranz zwischen zwei oder mehr physischen Gehäusen auszugleichen.
ProvisioningType [in]
Der Bereitstellungstyp für den virtuellen Datenträger.
Dünn (1)
Behoben (2)
RunAsJob [in]
Bei TRUE verwendet diese Methode den CreatedStorageJob-Parameter , wenn die Verarbeitung der Anforderung sehr lange dauert. Wenn ein Speicherauftrag zum Nachverfolgen des Vorgangs erstellt wurde, gibt diese Methode Die Methodenparameter Überprüft – Auftrag gestartet zurück.
Hinweis
Selbst wenn RunAsJobTRUE ist, kann diese Methode dennoch ein Ergebnis zurückgeben, wenn sie in ausreichender Zeit abgeschlossen wurde.
Bei FALSE oder NULL folgt diese Methode dem standardmäßigen asynchronen WMI-Verhalten, das von der -Methode des Clients für den Aufruf bestimmt wird. Anders ausgedrückt: Es ist synchron, sofern nicht anders angefordert.
CreatedVirtualDisk [out]
Wenn der virtuelle Datenträger erfolgreich erstellt wurde, empfängt dieser Parameter eine Zeichenfolge, die ein eingebettetes MSFT_VirtualDisk -Objekt enthält.
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 zeitintensiven Vorgangs verwendet wird.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Dieser Parameter ermöglicht es dem Speicheranbieter, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.
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)
Größe nicht unterstützt (4097)
Nicht genügend freier Speicherplatz (40000)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Veralteter Cache (40003)
Sie müssen eine Größe angeben, indem Sie entweder den Parameter Size oder UseMaximumSize verwenden. Sie können jeweils nur einen dieser Parameter angeben. (40005)
Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)
Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)
Es wurden keine Speicherpools gefunden, die diese Konfiguration des virtuellen Datenträgers unterstützen können. (47000)
Der Wert für NoSinglePointOfFailure wird nicht unterstützt. (49001)
Der Wert für PhysicalDiskRedundancy liegt außerhalb des unterstützten Wertebereichs. (49002)
Der Wert für NumberOfDataCopies liegt außerhalb des unterstützten Wertebereichs. (49003)
Der Wert für ParityLayout liegt außerhalb des unterstützten Wertebereichs. (49004)
Der Wert für Interleave liegt außerhalb des unterstützten Wertebereichs. (49005)
Der Wert für NumberOfColumns liegt außerhalb des unterstützten Wertebereichs. (49006)
Hinweise
Diese Methode wird in der Regel verwendet, wenn eine der folgenden Punkte zutrifft:
- Die Speicherpools des Speichersubsystems lassen die erstellung virtueller Datenträger nicht direkt zu.
- Das Speichersubsystem unterstützt keine Speicherpools.
Speicherverwaltungsanbieter können diese Methode auch implementieren, um einen Speicherpool für den Benutzer "intelligent" auszuwählen. Wenn diese Methode unterstützt wird, sollte die SupportsAutomaticStoragePoolSelection-Eigenschaft des Subsystems auf TRUE festgelegt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |