Metode IVdsLunControllerPorts::AssociateControllerPorts (vds.h)

Artikel
03/08/2023

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

Mengatur port pengontrol subsistem ke aktif atau tidak aktif sehubungan dengan LUN. Metode ini menggantikan IVdsLun::AssociateControllers.

Sintaks

HRESULT AssociateControllerPorts(
  VDS_OBJECT_ID *pActiveControllerPortIdArray,
  LONG          lNumberOfActiveControllerPorts,
  VDS_OBJECT_ID *pInactiveControllerPortIdArray,
  LONG          lNumberOfInactiveControllerPorts
);

Parameter

pActiveControllerPortIdArray

Penunjuk ke array GUID port pengontrol. Penyedia menyetel port pengontrol ini ke aktif. Array ini mencakup port pengontrol yang sudah diatur ke aktif yang akan tetap aktif.

lNumberOfActiveControllerPorts

Jumlah port pengontrol yang ditentukan dalam parameter pActiveControllerPortIdArray .

pInactiveControllerPortIdArray

Penunjuk ke array GUID port pengontrol. Penyedia mengatur port pengontrol ini menjadi tidak aktif. Array ini mencakup port pengontrol yang sudah diatur ke tidak aktif yang tetap tidak aktif.

lNumberOfInactiveControllerPorts

Jumlah port pengontrol yang ditentukan dalam parameter pInactiveControllerPortIdArray .

Nilai kembali

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
S_OK	Nama asosiasi berhasil disetel.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Cache penyedia rusak. Ini menunjukkan masalah perangkat lunak atau komunikasi di dalam penyedia yang menyimpan informasi tentang perangkat yang terpasang. Pemanggil dapat menggunakan 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 sebelumnya selesai.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Satu atau beberapa GUID jenis data VDS_OBJECT_ID ditentukan dalam parameter pActiveControllerPortIdArray atau pInactiveControllerPortIdArray tidak merujuk ke objek yang ada.
VDS_E_NOT_SUPPORTED 0x80042400L	Operasi atau kombinasi parameter ini tidak didukung oleh penyedia ini.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	vds.h
Redistribusi	VDS 1.1

Lihat juga

IVdsLunControllerPorts

Bagikan melalui