Metode IVdsLunMpio::GetLoadBalancePolicy (vds.h)

  • Artikel

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

Mengembalikan kebijakan keseimbangan beban saat ini pada LUN.

Sintaks

HRESULT GetLoadBalancePolicy(
  [out] VDS_LOADBALANCE_POLICY_ENUM *pPolicy,
  [out] VDS_PATH_POLICY             **ppPaths,
  [out] LONG                        *plNumberOfPaths
);

Parameter

[out] pPolicy

Penunjuk ke variabel yang menerima nilai enumerasi VDS_LOADBALANCE_POLICY_ENUM yang menentukan kebijakan keseimbangan beban.

[out] ppPaths

Penunjuk ke array struktur VDS_PATH_POLICY yang diteruskan oleh pemanggil. Pemanggil harus membebaskan array ini dengan menggunakan fungsi CoTaskMemFree .

[out] plNumberOfPaths

Penunjuk ke variabel yang menerima jumlah struktur informasi kebijakan khusus jalur yang dikembalikan dalam parameter ppPaths .

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
S_OK
 Kebijakan keseimbangan beban berhasil dikembalikan. Jika LUN tidak memiliki jalur, array kosong, nilai yang diacu oleh parameter plNumberOfPaths diatur ke 0, dan nilai yang diacu oleh parameter ppPaths diatur ke NULL.
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.

Keterangan

Jumlah jalur yang dikembalikan oleh metode ini akan cocok dengan jumlah jalur yang dikembalikan oleh metode IVdsLunMpio::GetPathInfo .

Persyaratan

Persyaratan Nilai
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

Lihat juga

IVdsLunMpio

IVdsLunMpio::GetLoadBalancePolicy

VDS_LOADBALANCE_POLICY_ENUM

VDS_PATH_POLICY