IVdsVDisk::Metode buka (vds.h)

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

Membuka handel ke file disk virtual yang ditentukan dan mengembalikan penunjuk antarmuka IVdsOpenVDisk ke objek yang mewakili handel yang dibuka.

Sintaks

HRESULT Open(
  [in]  VIRTUAL_DISK_ACCESS_MASK AccessMask,
  [in]  OPEN_VIRTUAL_DISK_FLAG   Flags,
  [in]  ULONG                    ReadWriteDepth,
  [out] IVdsOpenVDisk            **ppOpenVDisk
);

Parameter

[in] AccessMask

Bitmask bendera VIRTUAL_DISK_ACCESS_MASK yang menentukan hak akses yang akan diterapkan ke disk virtual yang dibuka.

[in] Flags

Bitmask bendera OPEN_VIRTUAL_DISK_FLAG yang menentukan bagaimana disk virtual akan dibuka.

[in] ReadWriteDepth

Jumlah penyimpanan (file cadangan), dimulai dengan anak, dari rantai penyimpanan cadangan untuk membuka baca/tulis. Penyimpanan yang tersisa dalam rantai yang berbeda akan dibuka baca-saja. (Ini diperlukan agar operasi penggabungan berhasil.)

[out] ppOpenVDisk

Penunjuk ke variabel yang menerima penunjuk antarmuka IVdsOpenVDisk ke objek yang baru dibuat yang mewakili handel yang dibuka ke objek disk virtual. Penelepon harus melepaskan penunjuk antarmuka ketika tidak lagi diperlukan 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.

Keterangan

Aplikasi harus menginisialisasi keamanan di seluruh proses dengan memanggil fungsi CoInitializeSecurity . Parameter dwImpLevel harus diatur ke RPC_C_IMP_LEVEL_IMPERSONATE.

Windows Server 2008, Windows Vista, dan Windows Server 2003: Tindakan ini tidak diperlukan sampai Windows 7 dan Windows Server 2008 R2.

Persyaratan

Lihat juga

IVdsVDisk