Metode IVdsSubSystem::QueryMaxLunCreateSize (vds.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Mengembalikan ukuran LUN maksimum yang dapat dibuat menggunakan jenis dan petunjuk LUN yang ditentukan.

Sintaks

HRESULT QueryMaxLunCreateSize(
  [in]  VDS_LUN_TYPE  type,
  [in]  VDS_OBJECT_ID *pDriveIdArray,
  [in]  LONG          lNumberOfDrives,
  [in]  VDS_HINTS     *pHints,
  [out] ULONGLONG     *pullMaxLunSize
);

Parameter

[in] type

Jenis LUN dijumlahkan oleh VDS_LUN_TYPE.

[in] pDriveIdArray

Penunjuk ke array yang berisi VDS_OBJECT_ID untuk setiap drive yang akan digunakan dalam pembuatan LUN. Penyedia harus mencoba menggunakan drive dalam urutan yang disediakan. Parameter ini bisa NULL jika parameter lNumberOfDrives adalah 0, dalam hal ini penyedia harus secara otomatis memilih drive.

[in] lNumberOfDrives

Jumlah entri dalam pDriveIdArray. Ini dapat diatur ke 0.

[in] pHints

Penunjuk ke struktur VDS_HINTS yang digunakan untuk membuat LUN. Petunjuk selalu lebih rendah prioritasnya daripada parameter yang tercantum sebelumnya. Argumen ini harus non-NULL.

[out] pullMaxLunSize

Penunjuk ke buffer yang berisi ukuran maksimum LUN dalam byte. Argumen ini harus non-NULL.

Mengembalikan nilai

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_INVALIDARG atau E_OUTOFMEMORY, dan nilai pengembalian khusus VDS. Ini juga dapat mengembalikan kode kesalahan sistem yang dikonversi menggunakan makro HRESULT_FROM_WIN32 . Kesalahan dapat berasal dari VDS itu sendiri atau dari penyedia VDS yang mendasar yang sedang digunakan. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Nilai pengembalian ini menandakan masalah perangkat lunak atau komunikasi di dalam penyedia yang menyimpan informasi tentang array. Gunakan metode IVdsHwProvider::Reenumerate diikuti dengan metode IVdsHwProvider::Refresh untuk memulihkan cache.
VDS_E_OBJECT_DELETED 0x8004240BL	Objek subsistem tidak ada lagi.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Subsistem dalam keadaan gagal dan tidak dapat melakukan operasi yang diminta.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Operasi lain sedang berlangsung; operasi ini tidak dapat dilanjutkan sampai operasi atau operasi sebelumnya selesai.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Dapat dikembalikan dari metode apa pun yang mengambil konstanta VDS_OBJECT_ID . Nilai pengembalian ini menunjukkan bahwa pengidentifikasi tidak merujuk ke objek yang ada.
VDS_E_NOT_SUPPORTED 0x80042400L	Operasi atau kombinasi parameter ini tidak didukung oleh penyedia ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	vds.h
Pustaka	Uuid.lib

Lihat juga

IVdsHwProvider::Hitung ulang

IVdsHwProvider::Refresh

IVdsSubSystem

VDS_HINTS

VDS_LUN_TYPE