Fungsi AttachVirtualDisk (virtdisk.h)

Melampirkan hard disk virtual (VHD) atau file gambar CD atau DVD (ISO) dengan menemukan penyedia VHD yang sesuai untuk menyelesaikan lampiran.

Sintaks

DWORD AttachVirtualDisk(
  [in]           HANDLE                          VirtualDiskHandle,
  [in, optional] PSECURITY_DESCRIPTOR            SecurityDescriptor,
  [in]           ATTACH_VIRTUAL_DISK_FLAG        Flags,
  [in]           ULONG                           ProviderSpecificFlags,
  [in, optional] PATTACH_VIRTUAL_DISK_PARAMETERS Parameters,
  [in, optional] LPOVERLAPPED                    Overlapped
);

Parameter

[in] VirtualDiskHandle

Handel ke disk virtual terbuka. Untuk informasi tentang cara membuka disk virtual, lihat fungsi OpenVirtualDisk .

[in, optional] SecurityDescriptor

Penunjuk opsional ke SECURITY_DESCRIPTOR untuk diterapkan ke disk virtual yang terpasang. Jika parameter ini NULL, pendeskripsi keamanan file gambar disk virtual digunakan.

Pastikan bahwa deskriptor keamanan yang AttachVirtualDisk berlaku untuk disk virtual terlampir memberikan izin atribut tulis untuk pengguna, atau bahwa pendeskripsi keamanan file gambar disk virtual memberikan izin atribut tulis untuk pengguna jika Anda menentukan NULL untuk parameter ini. Jika deskriptor keamanan tidak memberikan izin atribut tulis untuk pengguna, Shell menampilkan kesalahan berikut saat pengguna mengakses disk virtual yang terpasang: Keranjang Sampah rusak. Anda ingin mengosongkan Keranjang Sampah untuk kandar ini?

[in] Flags

Kombinasi nilai enumerasi ATTACH_VIRTUAL_DISK_FLAG yang valid.

[in] ProviderSpecificFlags

Bendera khusus untuk jenis disk virtual yang dilampirkan. Mungkin nol jika tidak ada yang diperlukan.

[in, optional] Parameters

Penunjuk ke struktur ATTACH_VIRTUAL_DISK_PARAMETERS valid yang berisi data parameter lampiran.

[in, optional] Overlapped

Penunjuk opsional ke struktur TUMPANG TINDIH yang valid jika operasi asinkron diinginkan.

Nilai kembali

Status permintaan.

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan. Untuk informasi selengkapnya, lihat Kode Kesalahan Sistem.

Keterangan

Fungsi AttachVirtualDisk tidak didukung untuk VHD atau ISO yang dihosting di media Secure Digital (SD) yang dicolokkan ke pengontrol SD dalam mode asli (yang sffdisk.sys, sffp_sd.sys, dan driver sdbus.sys akan dimuat) dan akan gagal dengan kesalahan ERROR_FILE_NOT_FOUND. VHD dan ISO yang dihosting di media SD yang terhubung ke pembaca USB didukung.

Jika fungsi AttachVirtualDisk gagal dengan nilai kode kesalahan ERROR_INVALID_PARAMETER, penyebabnya mungkin karena salah satu kondisi berikut:

• Parameter VirtualDiskHandle bukan handel valid yang dibuat oleh fungsi OpenVirtualDisk .
• Parameter Bendera diatur ke nilai yang lebih besar dari 0x020.
• Anggota versi parameter Parameter tidak diatur ke ATTACH_VIRTUAL_DISK_VERSION_1.

Volume host yang berisi file gambar disk virtual tidak dapat dikompresi atau EFS dienkripsi.

Fungsi ini akan gagal jika penyedia tidak dapat ditemukan, jika file gambar VHD atau ISO tidak valid, jika gambar VHD sudah terpasang, atau jika pemanggil tidak memiliki hak akses SE_MANAGE_VOLUME_PRIVILEGE . Untuk informasi selengkapnya tentang keamanan file, lihat Keamanan File dan Hak Akses.

Mode akses yang dimaksudkan dari disk virtual harus dipertimbangkan saat membuka handel disk virtual. Misalnya, jika disk virtual sedang dilampirkan untuk akses baca/tulis, parameter VirtualDiskHandle harus telah dibuka menggunakan bendera akses VIRTUAL_DISK_ACCESS_ATTACH_RW . Untuk informasi selengkapnya, lihat VIRTUAL_DISK_ACCESS_MASK dan OpenVirtualDisk.

File gambar CD dan DVD (ISO) tidak didukung sebelum Windows 8 dan Windows Server 2012.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	virtdisk.h
Pustaka	VirtDisk.lib
DLL	VirtDisk.dll

Lihat juga

Tentang VHD

Referensi VHD