CreateVolume-Methode der MSFT_StoragePool-Klasse
Erstellt einen virtuellen Datenträger und ein einzelnes Volume unter Verwendung der Ressourcen des Speicherpools.
Syntax
UInt32 CreateVolume(
[in] String FriendlyName,
[in] UInt64 Size,
[in] String StorageTiers[],
[in] UInt64 StorageTierSizes[],
[in] UInt16 ProvisioningType,
[in] String ResiliencySettingName,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt16 FileSystem,
[in] String AccessPath,
[in] String FileServer,
[out] String CreatedVolume,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Parameter
FriendlyName [in]
Der Anzeigename des Volumes. Der Anzeigename sollte das Volume beschreiben. Es muss nicht eindeutig sein. Die Bezeichnung des Dateisystems wird ebenfalls auf diesen Namen festgelegt.
Dieser Parameter ist erforderlich und darf nicht NULL sein.
Größe [in]
Die Größe des virtuellen Datenträgers. Beachten Sie, dass einige Speichersubsysteme die Größe auf ein Vielfaches ihrer Zuordnungseinheitengröße auf- oder herunterrunden. Die Größe des erstellten Volumes ist so groß, wie diese Größe des virtuellen Datenträgers zulässt.
StorageTiers [in]
Die Speicherebenen auf dem virtuellen Datenträger. Jedes Arrayelement ist ein MSFT_StorageTier-Objekt .
StorageTierSizes [in]
Die Größen der Ebenen.
ProvisioningType [in]
Der Bereitstellungstyp des Volumes.
| Wert | Bedeutung |
|---|---|
| 1 | Schlanke Bereitstellung: Der Speicher für das Volume wird bedarfsgesteuert zugeordnet. |
| 2 | Feste Bereitstellung: Der Speicher für das Volume wird zugeordnet, wenn das Volume erstellt wird. |
ResiliencySettingName [in]
Der Name der Resilienzeinstellung, die als Vorlage für dieses Volume verwendet werden soll. Sie entspricht der Name-Eigenschaft der Resilienzeinstellung instance. Es können nur Resilienzeinstellungen verwendet werden, die diesem Speicherpool zugeordnet sind.
PhysicalDiskRedundancy [in]
Die Anzahl von Physischen Datenträgerfehlern, denen der virtuelle Datenträger ohne Datenverlust standhalten kann. Wenn nicht angegeben, ist der verwendete Wert der PhysicalDiskRedundancyDefault-Member der durch ResiliencySettingName angegebenen Resilienzeinstellung.
NumberOfColumns [in]
Die Anzahl der physischen Datenträger, die zum Stripen der Daten verwendet werden sollen. Wenn nicht angegeben, ist der verwendete Wert der NumberOfColumnsDefault-Member der Resilienzeinstellung, die von ResiliencySettingName angegeben wird.
FileSystem [in]
Der Typ des Dateisystems, das auf dem erstellten Volume verwendet werden soll. Ein CSV-Dateisystem wird nur auf einem Subsystem für Speicherplätze unterstützt. Für CSV muss der Pool clusterfähig sein, und das erstellte Volume ist ein freigegebenes Clustervolume.
Dieser Parameter ist erforderlich und darf nicht NULL sein.
| Wert | Bedeutung |
|---|---|
| 14 | NTFS |
| 15 | ReFS |
| 0x8000 | CSVFS_NTFS |
| 0x8001 | CSVFS_ReFS |
AccessPath [in]
Ein lokaler Zugriffspfad zum Volume. Wenn der Zugriffspfad nicht festgelegt werden konnte oder dieser Parameter NULL ist, wird ein neuer Zugriffspfad zugewiesen.
FileServer [in]
Ab Windows 10: Eine Zeichenfolge, die ein eingebettetes MSFT_FileServer -Objekt enthält, das den Dateiserver darstellt, der dieses Volume besitzt.
CreatedVolume [out]
Das erstellte Volume, ein MSFT_Volume-Objekt .
CreatedStorageJob [out]
Gibt einen Verweis auf das Speicherauftragsobjekt zurück, das zum Nachverfolgen des zeitintensiven Vorgangs verwendet wird.
ExtendedStatus [out]
Erweiterte Fehlerinformationen in einem MSFT_StorageExtendedStatus-Objekt . Die Informationen sind implementierungsspezifisch.
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)
Ein unerwarteter E/A-Fehler ist aufgetreten. (40004)
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)
Der angeforderte Zugriffspfad wird bereits verwendet. (42002)
Der Zugriffspfad ist ungültig. (42007)
Das angegebene Dateisystem wird nicht unterstützt. (43001)
Das Volume kann nicht schnell formatiert werden. (43002)
Der angeforderte Vorgang kann nicht ausgeführt werden, wenn das Laufwerk schreibgeschützt ist. (43006)
Sie müssen einen Namen für dieses Volume angeben. (43017)
Sie müssen einen Dateiserver angeben, für den dieses Volume verfügbar gemacht werden soll. (43018)
Das Volume wird nicht für den angegebenen Dateiserver verfügbar gemacht. (43019)
Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)
Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)
Das Failoverclustering konnte für dieses Speicherobjekt nicht aktiviert werden. (46008)
Dieser Vorgang wird für ursprüngliche Speicherpools nicht unterstützt. (48000)
Der Speicherpool ist nur für spezielle Verwendungen reserviert. (48001)
Die angegebene Resilienzeinstellung wird von diesem Speicherpool nicht unterstützt. (48002)
Im Speicherpool sind nicht genügend physische Datenträger vorhanden, um die angegebene Konfiguration des virtuellen Datenträgers zu erstellen. (48004)
Der Speicherpool konnte den Vorgang nicht abschließen, da seine Integrität oder betriebliche status dies nicht zulässt. (48006)
Der Speicherpool konnte den Vorgang nicht abschließen, da seine Konfiguration schreibgeschützt ist. (48007)
Sie müssen die Größeninformationen (entweder den Parameter Size oder UseMaximumSize ) oder die Ebeneninformationen (Die Parameter StorageTiers und StorageTierSizes ) angeben, aber nicht sowohl Größeninformationen als auch Ebeneninformationen. (48010)
Es ist keine Resilienzeinstellung mit diesem Namen vorhanden. (49000)
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)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 [nur Desktop-Apps] |
| Namespace | Stamm\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |