Metode IVdsService::GetObject (vds.h)

  • Artikel

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

Mengembalikan penunjuk objek untuk objek yang diidentifikasi.

Sintaks

HRESULT GetObject(
  [in]  VDS_OBJECT_ID   ObjectId,
  [in]  VDS_OBJECT_TYPE type,
  [out] IUnknown        **ppObjectUnk
);

Parameter

[in] ObjectId

GUID objek yang diinginkan.

[in] type

Nilai enumerasi VDS_OBJECT_TYPE yang menentukan jenis objek. VDS_OT_UNKNOWN, VDS_OT_PROVIDER, VDS_OT_ASYNC, VDS_OT_ENUM, dan VDS_OT_OPEN_VDISK tidak didukung.

[out] ppObjectUnk

Penunjuk ke buffer yang menerima penunjuk IUnknown ke objek . Ketika pointer tidak lagi diperlukan, pemanggil harus merilisnya dengan memanggil metode IUnknown::Release .

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
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Objek dengan pengidentifikasi dan jenis yang ditentukan tidak ditemukan.
VDS_E_INITIALIZED_FAILED
0x80042401L
 VDS gagal diinisialisasi. Jika aplikasi memanggil metode ini sebelum layanan selesai diinisialisasi, metode diblokir hingga inisialisasi selesai. Jika inisialisasi gagal, kesalahan ini dikembalikan.

Keterangan

Pemberitahuan VDS mengembalikan pengidentifikasi objek alih-alih penunjuk objek. Penelepon menggunakan metode ini untuk mendapatkan penunjuk ke objek yang dirujuk dalam pemberitahuan.

Persyaratan

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

Lihat juga

IVdsService

VDS_OBJECT_TYPE