Metode IVdsVolumeMF::D eleteAccessPath (vds.h)

Artikel
03/08/2023

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

Menghapus jalur akses dari volume saat ini.

Sintaks

HRESULT DeleteAccessPath(
  [in] LPWSTR pwszPath,
  [in] BOOL   bForce
);

Parameter

[in] pwszPath

String yang berisi jalur akses yang akan dihapus. Jalur akses dapat berupa huruf kandar atau jalur ke direktori kosong pada volume NTFS. Jika ini adalah huruf kandar, Anda harus menyertakan garis miring terbelakang berikutnya, misalnya, "F:". Jika itu adalah jalur ke direktori, garis miring terbelakang tidak diperlukan, misalnya, "C:\MyFolder\MyDocuments".

[in] bForce

Jika TRUE, jalur akses dihapus tanpa syarat, meskipun volume sedang digunakan. Parameter ini bermakna hanya ketika jalur akses adalah huruf kandar.

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	Metode berhasil diselesaikan.
VDS_E_OPERATION_DENIED 0x8004240AL	Jalur mengarah ke volume sistem, volume boot, volume crashdump, volume hibernasi, atau volume pagefile. Anda tidak dapat menghapus huruf kandar dari volume ini.
VDS_E_PATH_NOT_FOUND 0x80042416L	Jalur yang ditentukan tidak ditemukan.
VDS_E_DEVICE_IN_USE 0x80042413L	Jalur akses berhasil dihapus, namun, terjadi kesalahan. VDS mungkin gagal memperbarui atribut tabel partisi GUID (GPT) dari partisi atau gagal menghapus berbagi jaringan default (seperti F$) saat menghapus huruf kandar.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Volume gagal.
VDS_E_PACK_OFFLINE 0x80042444L	Paket yang berisi volume tidak dapat diakses.

Keterangan

Jika tidak ada handel terbuka pada volume, huruf kandar akan segera dihapus. Namun, jika ada handel terbuka pada volume, volume tidak dapat dikunci dan huruf kandar dihapus saat komputer dimulai ulang.

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

IVdsVolumeMF::AddAccessPath

IVdsVolumeMF::QueryAccessPaths

Bagikan melalui