MSFT_StoragePool 類別的 CreateVolume 方法

使用存放集區的資源建立虛擬磁碟和單一磁碟區。

語法

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
);

參數

FriendlyName [in]

磁碟區的易記名稱。 易記名稱應該描述磁碟區。 它不需要是唯一的。 檔案系統的標籤也會設定為此名稱。

這個參數是必要的，而且不能是 NULL。

大小 [in]

虛擬磁碟的大小。 請注意，某些儲存子系統會將大小向上或向下四捨五入到其配置單位大小的倍數。 所建立磁碟區的大小將會像此虛擬磁碟大小允許一樣大。

StorageTiers [in]

虛擬磁碟上的儲存層。 每個陣列元素都是 MSFT_StorageTier 物件。

StorageTierSizes [in]

階層的大小。

ProvisioningType [in]

磁碟區的布建類型。

ResiliencySettingName [in]

要作為此磁碟區範本的復原設定名稱。 它與復原設定實例的 Name 屬性相同。 只能使用與此存放集區相關聯的復原設定。

PhysicalDiskRedundancy [in]

虛擬磁碟可承受的實體磁碟失敗數目，而不會遺失數據。 如果未指定，使用的值為 ResiliencySettingName 所指定之復原設定的 PhysicalDiskRedundancyDefault 成員。

NumberOfColumns [in]

用來等量數據之實體磁碟的數目。 如果未指定，使用的值為 ResiliencySettingName 所指定之復原設定的 NumberOfColumnsDefault 成員。

FileSystem [in]

要用於所建立磁碟區的文件系統類型。 只有儲存空間子系統才支援 CSV 檔案系統。 針對 CSV，集區必須是可叢集的，而建立的磁碟區將會是叢集共用磁碟區。

這個參數是必要的，而且不能是 NULL。

AccessPath [in]

磁碟區的本機存取路徑。 如果無法設定存取路徑，或此參數為 NULL，則會指派新的存取路徑。

FileServer [in]

從 Windows 10 開始：包含內嵌MSFT_FileServer物件的字串，代表將擁有此磁碟區的文件伺服器。

CreatedVolume [out]

已建立的磁碟區， MSFT_Volume 物件。

CreatedStorageJob [out]

傳回用來追蹤長時間執行作業之記憶體作業對象的參考。

ExtendedStatus [out]

MSFT_StorageExtendedStatus物件中的擴充錯誤資訊。 此資訊是實作特定的。

傳回值

成功 (0)

不支援 (1)

未指定的錯誤 (2)

逾 時 (3)

失敗 (4)

無效的參數 (5)

已檢查方法參數 - 作業啟動 (4096)

不支援大小 (4097)

沒有足夠的可用空間 (40000)

(40001) 拒絕存取

沒有足夠的資源可完成作業。 (40002)

發生非預期的 I/O 錯誤。 (40004)

您必須使用 Size 或 UseMaximumSize 參數來指定大小。 您一次只能指定其中一個參數。 (40005)

所要求的存取路徑已在使用中。 (42002)

存取路徑無效。 (42007)

不支援指定的檔案系統。 (43001)

磁碟區無法快速格式化。 (43002)

當磁碟驅動器是唯讀時，無法執行要求的作業。 (43006)

您必須為此磁碟區指定名稱。 (43017)

您必須指定要公開此磁碟區的檔案伺服器。 (43018)

磁碟區不會公開至指定的檔案伺服器。 (43019)

無法連線到記憶體提供者。 (46000)

儲存提供者無法連線到儲存子系統。 (46001)

無法為此記憶體物件啟用故障轉移叢集。 (46008)

在預備儲存集區上不支援此作業。 (48000)

儲存集區僅保留供特殊使用。 (48001)

此存放集區不支援指定的復原設定。 (48002)

存放集區中沒有足夠的實體磁碟可建立指定的虛擬磁碟組態。 (48004)

儲存集區無法完成作業，因為其健全狀況或作業狀態不允許。 (48006)

儲存集區無法完成作業，因為其設定是唯讀的。 (48007)

您必須指定 Size 或 UseMaximumSize 參數 (size 或 UseMaximumSize 參數) 或階層資訊 (StorageTiers 和 StorageTierSizes 參數) ，但不能同時指定大小資訊和階層資訊。 (48010)

沒有具有該名稱的復原設定。 (49000)

不支援 NoSinglePointOfFailure 的值。 (49001)

PhysicalDiskRedundancy 的值超出支援的值範圍。 (49002)

NumberOfDataCopies 的值超出支援的值範圍。 (49003)

ParityLayout 的值超出支援的值範圍。 (49004)

Interleave 的值超出支援的值範圍。 (49005)

NumberOfColumns 的值超出支援的值範圍。 (49006)

規格需求

另請參閱

MSFT_StoragePool