IVdsIscsiPortalGroup::Metode AddPortal (vdshwprv.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]
Menambahkan portal ke grup portal. Portal hanya dapat termasuk dalam satu grup portal dalam target tertentu. Ini dapat termasuk dalam grup portal lain di target lain.
Sintaks
HRESULT AddPortal(
[in] VDS_OBJECT_ID portalId,
[out] IVdsAsync **ppAsync
);
Parameter
[in] portalId
VDS_OBJECT_ID portal yang akan ditambahkan ke grup portal.
[out] ppAsync
Alamat penunjuk antarmuka IVdsAsync . VDS menginisialisasi antarmuka yang dikembalikan. Penelepon harus merilis antarmuka. Gunakan antarmuka ini untuk membatalkan, menunggu, atau mengkueri status operasi. Jika IVdsAsync::Wait dipanggil dan nilai HRESULT berhasil dikembalikan, antarmuka yang dikembalikan dalam struktur VDS_ASYNC_OUTPUT harus dirilis dengan memanggil metode IUnknown::Release pada setiap penunjuk antarmuka. Namun, jika Wait mengembalikan nilai HRESULT yang gagal, atau jika parameter pHrResultWait menerima nilai HRESULT yang gagal, penunjuk antarmuka dalam struktur VDS_ASYNC_OUTPUTadalah NULL dan tidak perlu dirilis. Anda dapat menguji keberhasilan atau kegagalan nilai HRESULT dengan menggunakan makro BERHASIL dan GAGAL yang ditentukan dalam Winerror.h.
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 |
---|---|
|
Portal berhasil ditambahkan ke grup portal. |
|
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 grup portal tidak lagi ada. |
|
Operasi lain sedang berlangsung. Operasi ini tidak dapat dilanjutkan hingga operasi sebelumnya selesai. |
|
Parameter portalID tidak merujuk ke objek yang ada. |
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 |
Redistribusi | VDS 1.1 |