Metode IVdsLunNumber::GetLunNumber (vds.h)

  • Artikel

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

Mengambil nomor LUN untuk LUN.

Sintaks

HRESULT GetLunNumber(
  [out] ULONG *pulLunNumber
);

Parameter

[out] pulLunNumber

Alamat variabel yang menerima nomor LUN. Nilai ini diperlukan dan tidak boleh 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. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.

Keterangan

Metode ini mengembalikan nomor LUN yang ditetapkan penyedia perangkat keras VDS ke LUN. Angka ini mengidentifikasi LUN dalam array disk. Ini tidak sama dengan "Nomor Unit Logis" di alamat SCSI disk. Setiap LUN dalam array disk ditetapkan tepat satu nomor LUN.

Metode ini ada karena utilitas DiskRAID menetapkan indeksnya sendiri untuk setiap LUN ketika menghitung LUN dalam subsistem. Tetapi indeks ini dapat berubah setiap kali DiskRAID dijalankan, jika penyedia perangkat keras menghitung LUN dalam urutan yang berbeda. Ini bisa membingungkan bagi pengguna akhir. Untuk array disk yang memiliki nomor LUN mereka sendiri (ditetapkan penyedia), metode ini memberi pemanggil kemampuan untuk memetakan nomor LUN ke indeks LUN yang ditetapkan oleh DiskRAID.

Jika subsistem mendukung penomoran LUN, subsistem dapat menunjukkan dukungan ini dengan mengatur bendera VDS_SF_SUPPORTS_LUN_NUMBER di anggota ulFlags dari struktur VDS_SUB_SYSTEM_PROP atau VDS_SUB_SYSTEM_PROP2 . Untuk informasi selengkapnya tentang bendera ini, lihat enumerasi VDS_SUB_SYSTEM_FLAG .

Persyaratan

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

Lihat juga

IVdsLunNumber