Fungsi SetVolumeMountPointA (winbase.h)

Mengaitkan volume dengan huruf kandar atau direktori pada volume lain.

Sintaksis

BOOL SetVolumeMountPointA(
  [in] LPCSTR lpszVolumeMountPoint,
  [in] LPCSTR lpszVolumeName
);

Parameter

[in] lpszVolumeMountPoint

Jalur mode pengguna yang akan dikaitkan dengan volume. Ini mungkin huruf kandar (misalnya, "X:\") atau direktori pada volume lain (misalnya, "Y:\MountX\"). String harus diakhir dengan garis miring terbelakang ('\').

[in] lpszVolumeName

Volume jalur GUID untuk volume. String ini harus berupa formulir "\\?\Volume{GUID}\" di mana GUID adalah GUID yang mengidentifikasi volume. "\\?\" menonaktifkan penguraian jalur dan diabaikan sebagai bagian dari jalur, seperti yang dibahas dalam Penamaan Volume.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Jika parameter lpszVolumeMountPoint berisi jalur ke folder yang dipasang, GetLastError mengembalikan ERROR_DIR_NOT_EMPTY, meskipun direktori kosong.

Komentar

Ketika fungsi ini digunakan untuk mengaitkan volume dengan direktori pada volume lain, direktori terkait disebut folder yang dipasang .

Ini adalah kesalahan untuk mengaitkan volume dengan direktori yang memiliki file atau subdirektori di dalamnya. Kesalahan ini terjadi untuk direktori sistem dan tersembunyi serta direktori lain, dan itu terjadi untuk sistem dan file tersembunyi.

Ketika folder yang dipasang dibuat pada volume pada disk berkluster, folder tersebut mungkin dihapus secara tak terduga dalam keadaan tertentu. Untuk informasi tentang cara membuat dan mengonfigurasi folder yang dipasang untuk memastikan bahwa ini tidak terjadi, lihat Disk Kluster dan Masalah Koneksi Drive.

IIn Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Tidak
Failover Transparan (TFO) SMB 3.0	Tidak
SMB 3.0 dengan Scale-out File Shares (SO)	Tidak
Sistem File Volume Bersama Kluster (CsvFS)	Tidak
Sistem File Tangguh (ReFS)	Tidak

 

SMB tidak mendukung fungsi manajemen volume. Untuk CsvFS, titik pemasangan baru tidak akan direplikasi ke node lain pada kluster.

Contoh

Misalnya, lihat Membuat Folder yang Dipasang.

Nota

Header winbase.h mendefinisikan SetVolumeMountPoint sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

DeleteVolumeMountPoint

GetVolumeNameForVolumeMountPoint

GetVolumePathName

Folder terpasang

Fungsi Manajemen Volume