IVdsLun::Metode penyusutan (vds.h)

Artikel
03/03/2024

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Menyusutkan LUN dengan jumlah byte tertentu.

Sintaks

HRESULT Shrink(
  [in]  ULONGLONG ullNumberOfBytesToRemove,
  [out] IVdsAsync **ppAsync
);

Parameter

[in] ullNumberOfBytesToRemove

Jumlah byte untuk menyusutkan LUN. Jumlah byte tidak diperlukan untuk menjadi kelipatan genap dari ukuran blok atau sektor.

[out] ppAsync

Alamat penunjuk antarmuka IVdsAsync . Penelepon harus merilis antarmuka. Gunakan antarmuka ini untuk membatalkan, menunggu, atau mengkueri status operasi.

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. Kemungkinan nilai yang 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 LUN tidak lagi ada.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	LUN 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.

Keterangan

Pelaksana harus mengembalikan pointer ke antarmuka IVdsAsync untuk metode ini, terlepas dari apakah panggilan memulai operasi asinkron.

Setelah LUN disusutkan, pemanggil harus menggunakan kode kontrol IOCTL_DISK_UPDATE_PROPERTIES untuk membuat ukuran disk yang diperbarui terlihat di komputer tempat LUN dibuka kemasannya.

Pelaksana harus menghapus byte dari akhir LUN.

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

IVdsAsync

IVdsHwProvider::Hitung ulang

IVdsHwProvider::Refresh

IVdsLun

IVdsLun::Extend

Bagikan melalui