Metode CreateVolume dari kelas MSFT_StoragePool
Membuat disk virtual dan volume tunggal menggunakan sumber daya kumpulan penyimpanan.
Sintaks
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]
Nama volume yang mudah diingat. Nama yang mudah diingat harus menggambarkan volume. Ini tidak perlu unik. Label sistem file juga akan diatur ke nama ini.
Parameter ini diperlukan dan tidak boleh NULL.
Ukuran [in]
Ukuran disk virtual. Perhatikan bahwa beberapa subsistem penyimpanan akan membulatkan ukuran ke atas atau ke bawah ke kelipatan ukuran unit alokasinya. Ukuran volume yang dibuat akan sebesar yang diizinkan oleh ukuran disk virtual ini.
StorageTiers [in]
Tingkat penyimpanan pada disk virtual. Setiap elemen array adalah objek MSFT_StorageTier .
StorageTierSizes [in]
Ukuran tingkatan.
ProvisioningType [in]
Jenis provisi volume.
| Nilai | Makna |
|---|---|
| 1 | Provisi tipis - penyimpanan untuk volume dialokasikan sesuai permintaan. |
| 2 | Provisi tetap - penyimpanan untuk volume dialokasikan saat volume dibuat. |
ResiliencySettingName [in]
Nama pengaturan ketahanan yang akan digunakan sebagai templat untuk volume ini. Ini sama dengan properti Nama dari instans pengaturan ketahanan. Hanya pengaturan ketahanan yang terkait dengan kumpulan penyimpanan ini yang dapat digunakan.
PhysicalDiskRedundancy [in]
Jumlah kegagalan disk fisik yang dapat ditahan disk virtual tanpa kehilangan data. Jika tidak ditentukan, nilai yang digunakan adalah anggota PhysicalDiskRedundancyDefault dari pengaturan ketahanan yang ditentukan oleh ResiliencySettingName.
NumberOfColumns [in]
Jumlah disk fisik yang digunakan untuk menghapus data. Jika tidak ditentukan, nilai yang digunakan adalah anggota NumberOfColumnsDefault dari pengaturan ketahanan yang ditentukan oleh ResiliencySettingName.
FileSystem [in]
Jenis sistem file yang akan digunakan pada volume yang dibuat. Sistem file CSV hanya didukung pada subsistem ruang penyimpanan. Untuk CSV, kumpulan harus dapat diklusterkan dan volume yang dibuat akan menjadi volume bersama kluster.
Parameter ini diperlukan dan tidak boleh NULL.
| Nilai | Makna |
|---|---|
| 14 | NTFS |
| 15 | ReFS |
| 0x8000 | CSVFS_NTFS |
| 0x8001 | CSVFS_ReFS |
AccessPath [in]
Jalur akses lokal ke volume. Jika jalur akses tidak dapat diatur, atau parameter ini adalah NULL, jalur akses baru akan ditetapkan.
FileServer [in]
Mulai dari Windows 10: String yang berisi objek MSFT_FileServer yang disematkan, mewakili server file yang akan memiliki volume ini.
CreatedVolume [out]
Volume yang dibuat, objek MSFT_Volume .
CreatedStorageJob [out]
Mengembalikan referensi ke objek pekerjaan penyimpanan yang digunakan untuk melacak operasi yang berjalan lama.
ExtendedStatus [out]
Informasi kesalahan yang diperluas dalam objek MSFT_StorageExtendedStatus . Informasi ini khusus untuk implementasi.
Mengembalikan nilai
Sukses (0)
Tidak Didukung (1)
Kesalahan yang Tidak Ditentukan (2)
Waktu habis (3)
Gagal (4)
Parameter Tidak Valid (5)
Parameter Metode Diperiksa - Pekerjaan Dimulai (4096)
Ukuran Tidak Didukung (4097)
Tidak cukup ruang kosong (40000)
Akses ditolak (40001)
Tidak ada cukup sumber daya untuk menyelesaikan operasi. (40002)
Terjadi kesalahan I/O yang tidak terduga. (40004)
Anda harus menentukan ukuran dengan menggunakan parameter Ukuran atau UseMaximumSize . Anda hanya dapat menentukan salah satu parameter ini pada satu waktu. (40005)
Jalur akses yang diminta sudah digunakan. (42002)
Jalur akses tidak valid. (42007)
Sistem file yang ditentukan tidak didukung. (43001)
Volume tidak dapat diformat dengan cepat. (43002)
Tidak dapat melakukan operasi yang diminta ketika drive dibaca saja. (43006)
Anda harus menentukan nama untuk volume ini. (43017)
Anda harus menentukan server file untuk mengekspos volume ini. (43018)
Volume tidak terekspos ke server file yang ditentukan. (43019)
Tidak dapat tersambung ke penyedia penyimpanan. (46000)
Penyedia penyimpanan tidak dapat tersambung ke subsistem penyimpanan. (46001)
Pengklusteran failover tidak dapat diaktifkan untuk objek penyimpanan ini. (46008)
Operasi ini tidak didukung pada kumpulan penyimpanan primordial. (48000)
Kumpulan penyimpanan hanya dicadangkan untuk penggunaan khusus. (48001)
Pengaturan ketahanan yang ditentukan tidak didukung oleh kumpulan penyimpanan ini. (48002)
Tidak ada cukup disk fisik di kumpulan penyimpanan untuk membuat konfigurasi disk virtual yang ditentukan. (48004)
Kumpulan penyimpanan tidak dapat menyelesaikan operasi karena status kesehatan atau operasionalnya tidak mengizinkannya. (48006)
Kumpulan penyimpanan tidak dapat menyelesaikan operasi karena konfigurasinya baca-saja. (48007)
Anda harus menentukan info ukuran (parameter Ukuran atau UseMaximumSize ) atau info tingkat (parameter StorageTiers dan StorageTierSizes ), tetapi bukan info ukuran dan info tingkat. (48010)
Tidak ada pengaturan ketahanan dengan nama tersebut. (49000)
Nilai untuk NoSinglePointOfFailure tidak didukung. (49001)
Nilai untuk PhysicalDiskRedundancy berada di luar rentang nilai yang didukung. (49002)
Nilai untuk NumberOfDataCopies berada di luar rentang nilai yang didukung. (49003)
Nilai untuk ParityLayout berada di luar rentang nilai yang didukung. (49004)
Nilai untuk Interleave berada di luar rentang nilai yang didukung. (49005)
Nilai untuk NumberOfColumns berada di luar rentang nilai yang didukung. (49006)
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8.1 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 R2 [hanya aplikasi desktop] |
| Ruang nama | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |