Metode IVdsIscsiTarget::CreatePortalGroup (vds.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Membuat grup portal. Penunjuk antarmuka untuk objek grup portal baru dapat diambil dengan memanggil IVdsAsync::Tunggu melalui parameter ppAsync . Struktur VDS_ASYNC_OUTPUT yang dikembalikan berisi penunjuk antarmuka objek volume di anggota cpg.pPortalGroupUnk .

Sintaks

HRESULT CreatePortalGroup(
  [out] IVdsAsync **ppAsync
);

Parameter

[out] ppAsync

Alamat penunjuk antarmuka IVdsAsync , yang diinisialisasi VDS saat dikembalikan. Penelepon harus merilis antarmuka. Gunakan antarmuka ini untuk membatalkan, menunggu, atau mengkueri status operasi. Jika Anda memanggil metode IVdsAsync::Wait pada antarmuka ini dan nilai HRESULT yang berhasil dikembalikan, Anda harus melepaskan antarmuka yang dikembalikan dalam struktur VDS_ASYNC_OUTPUT 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.

Nilai kembali

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
S_OK
 Grup portal berhasil dibuat.
VDS_S_ALREADY_EXISTS
0x00042714L
 Tidak ada lagi grup portal yang dapat dibuat. Metode CreatePortalGroup tidak membuat grup portal baru. Jika Anda memanggil metode IVdsAsync::Wait pada penunjuk antarmuka yang dikembalikan dalam parameter ppAsync , objek grup portal yang ada akan diambil.
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 target tidak lagi ada.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
 Operasi lain sedang berlangsung; operasi ini tidak dapat dilanjutkan sampai operasi sebelumnya selesai.

Persyaratan

   
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

IVdsAsync

IVdsIscsiTarget