Metode IVdsLunMpio::GetPathInfo (vds.h)

  • Artikel

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

Mengembalikan array struktur VDS_PATH_INFO , satu untuk setiap jalur ke LUN.

Sintaks

HRESULT GetPathInfo(
  [out] VDS_PATH_INFO **ppPaths,
  [out] LONG          *plNumberOfPaths
);

Parameter

[out] ppPaths

Alamat variabel yang menerima array struktur VDS_PATH_INFO . Pemanggil harus membebaskan setiap elemen dalam array, dan array itu sendiri, dengan menggunakan fungsi CoTaskMemFree .

[out] plNumberOfPaths

Alamat variabel yang menerima jumlah elemen dalam array yang dikembalikan dalam parameter ppPaths .

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

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
 Informasi jalur berhasil dikembalikan.
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

Penyedia perangkat keras tidak perlu mengembalikan VDS_OBJECT_ID pada hbaPortProp.id VDS_PATH_INFO dan hanya harus mengatur ini ke GUID_NULL. ID ini akan diisi oleh sistem ketika panggilan ini diteruskan kembali ke aplikasi. Jika layanan tidak dapat menemukan port HBA yang sesuai, GUID_NULL akan digunakan. Aplikasi akan menginterpretasikan ini berarti bahwa port HBA tidak diketahui oleh VDS.

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
Pustaka Uuid.lib
Redistribusi VDS 1.1

Lihat juga

IVdsLunMpio

VDS_PATH_INFO