IVdsOpenVDisk::Lampirkan metode (vds.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Melampirkan disk virtual.

Sintaks

HRESULT Attach(
  [in]  LPWSTR                   pStringSecurityDescriptor,
  [in]  ATTACH_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                    ProviderSpecificFlags,
  [in]  ULONG                    TimeoutInMs,
  [out] IVdsAsync                **ppAsync
);

Parameter

[in] pStringSecurityDescriptor

String yang berisi deskriptor keamanan untuk disk virtual. Jika tidak ditentukan, deskriptor keamanan yang digunakan adalah: "D:P(A;; GA;;; WD)" pada Windows 7, dan "D:P(A;; GA;;; WD)(A;; GA;;; AC)" pada Windows 8.1 dan yang lebih baru.

[in] Flags

Bitmask dari nilai enumerasi ATTACH_VIRTUAL_DISK_FLAG yang menentukan bagaimana disk virtual akan dilampirkan. Nilai yang mungkin termasuk yang berikut ini.

Nilai Makna
ATTACH_VIRTUAL_DISK_FLAG_NONE
0x00000000
 Tidak ada bendera yang ditentukan.
ATTACH_VIRTUAL_DISK_FLAG_READ_ONLY
0x00000001
 Lampirkan disk virtual sebagai baca-saja.
ATTACH_VIRTUAL_DISK_FLAG_NO_DRIVE_LETTER
0x00000002
 Pasang semua volume pada disk virtual yang terpasang tanpa menetapkan huruf kandar padanya.
ATTACH_VIRTUAL_DISK_FLAG_PERMANENT_LIFETIME
0x00000004
 Layanan VDS secara otomatis mengatur bendera ini sehingga VHD tetap terpasang hingga metode IVdsOpenVDisk::D etach dipanggil untuk mencopotnya.
ATTACH_VIRTUAL_DISK_FLAG_NO_LOCAL_HOST
0x00000008
 Dicadangkan. Jangan gunakan.

[in] ProviderSpecificFlags

Bitmask bendera yang khusus untuk jenis disk virtual yang sedang dilampirkan. Bendera ini khusus untuk penyedia. Untuk penyedia disk virtual Microsoft, parameter ini harus nol.

[in] TimeoutInMs

Parameter ini dicadangkan untuk digunakan di masa mendatang.

[out] ppAsync

Penunjuk ke antarmuka IVdsAsync yang setelah berhasil diselesaikan menerima antarmuka IVdsAsync untuk memantau dan mengontrol operasi ini. Penelepon harus merilis antarmuka yang diterima ketika mereka telah selesai dengannya. Jika metode IVdsAsync::Wait dipanggil pada antarmuka dan nilai HRESULT sukses dikembalikan, antarmuka yang dikembalikan dalam struktur VDS_ASYNC_OUTPUT harus dirilis dengan memanggil metode IUnknown::Release pada setiap pointer antarmuka. Namun, jika Wait mengembalikan nilai HRESULT kegagalan, atau jika parameter pHrResultWait menerima nilai HRESULT kegagalan, penunjuk antarmuka dalam struktur VDS_ASYNC_OUTPUT adalah 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. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.

Keterangan

Saat disk virtual terpasang, pemanggil dapat menerima satu atau semua pemberitahuan berikut:

  • Jika penelepon terdaftar untuk pemberitahuan VDS, penelepon menerima pemberitahuan kedatangan disk. Untuk informasi selengkapnya, lihat Pemberitahuan VDS.
  • Jika penelepon terdaftar untuk pemberitahuan PnP, pemanggil menerima pemberitahuan kedatangan disk PnP. Untuk informasi selengkapnya, lihat RegisterDeviceNotification.
Aplikasi harus menginisialisasi keamanan 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

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

Lihat juga

IVdsOpenVDisk