Metode IVdsLunNaming::SetFriendlyName (vdshwprv.h)

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

Mengatur nama yang mudah diingat dari LUN.

Syntax

HRESULT SetFriendlyName(
  LPWSTR pwszFriendlyName
);

Parameter-parameternya

pwszFriendlyName

Penunjuk ke string null-terminated yang menentukan nama yang akan ditetapkan ke LUN.

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 dasar yang sedang digunakan. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Description
S_OK	Nama berhasil disetel.
VDS_S_NAME_TRUNCATED 0x00042700L	Nama berhasil ditetapkan tetapi harus dipotong karena keterbatasan dalam subsistem. Nama yang ditetapkan mungkin tidak cocok dengan nama yang diteruskan dalam parameter pwszName .
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Cache penyedia rusak. Ini menunjukkan perangkat lunak atau masalah 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 ada lagi.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	LUN dalam status gagal dan tidak dapat melakukan operasi yang diminta.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Operasi lain sedang berlangsung. Operasi ini tidak dapat dilanjutkan hingga operasi sebelumnya selesai.
VDS_E_NOT_SUPPORTED 0x80042400L	Operasi ini tidak didukung oleh penyedia ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 R2 [hanya aplikasi desktop]
Platform Target	Windows
Header	vdshwprv.h

Lihat juga

IVdsLunNaming