Metode IVdsVolumeMF::AddAccessPath (vds.h)

  • Artikel

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

Menambahkan jalur akses.

Sintaks

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

Parameter

[in] pwszPath

String yang menunjukkan jalur akses, yang merupakan jalur mode pengguna yang dapat digunakan untuk membuka volume. Jalur akses dapat berupa huruf kandar atau jalur ke direktori kosong pada volume NTFS. String jalur akses harus menyertakan garis miring terbelakang berikutnya, misalnya, "F:".

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
S_OK
 Jalur berhasil ditambahkan.
S_FALSE
 Jalur akses berhasil ditambahkan, namun, terjadi kesalahan. VDS mungkin gagal memperbarui atribut GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER partisi atau gagal menambahkan berbagi jaringan default (seperti F$) saat menambahkan huruf kandar. Untuk informasi selengkapnya, lihat PARTITION_INFORMATION_GPT.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Volume gagal.
VDS_E_PACK_OFFLINE
0x80042444L
 Paket yang berisi volume tidak dapat diakses.

Keterangan

VDS menambahkan jalur akses dengan membuat folder yang dipasang (juga disebut titik pemasangan volume). Perhatikan bahwa folder yang dipasang hanya didukung pada volume NTFS. Untuk informasi selengkapnya, lihat Folder terpasang.

Metode ini mengembalikan ERROR_DIR_NOT_EMPTY jika parameter pwszPath berisi jalur ke folder yang dipasang yang sudah digunakan (bahkan jika direktori kosong) atau jika pwszPath berisi jalur ke direktori yang tidak kosong.

Persyaratan

   
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

IVdsVolumeMF

SetVolumeMountPoint