Metode IVdsSubSystemNaming::SetFriendlyName (vdshwprv.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]
Mengatur nama subsistem yang mudah diingat.
Sintaks
HRESULT SetFriendlyName(
LPWSTR pwszFriendlyName
);
Parameter
pwszFriendlyName
Penunjuk ke string yang dihentikan null yang menentukan nama yang akan ditetapkan ke subsistem.
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. Nilai yang mungkin dikembalikan termasuk yang berikut ini.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Nama berhasil disetel. |
|
Nama berhasil ditetapkan tetapi harus dipotong karena keterbatasan dalam subsistem. Nama yang ditetapkan mungkin tidak cocok dengan nama yang diteruskan dalam parameter pwszName . |
|
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. |
|
Objek subsistem tidak ada lagi. |
|
Subsistem dalam keadaan gagal dan tidak dapat melakukan operasi yang diminta. |
|
Operasi lain sedang berlangsung. Operasi ini tidak dapat dilanjutkan sampai operasi sebelumnya selesai. |
|
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] |
Target Platform | Windows |
Header | vdshwprv.h |
Pustaka | Uuid.lib |