Fungsi FilterGetDosName (fltuser.h)

Artikel
02/29/2024

Fungsi FilterGetDosName mengembalikan nama perangkat MS-DOS yang sesuai dengan nama volume yang diberikan.

Sintaks

HRESULT FilterGetDosName(
  [in]  LPCWSTR lpVolumeName,
  [out] LPWSTR  lpDosName,
  [in]  DWORD   dwDosNameBufferSize
);

Parameter

[in] lpVolumeName

Penunjuk ke string karakter lebar yang dihentikan NULL yang berisi nama volume.

String input lpVolumeName dapat berupa salah satu dari berikut ini. Garis miring terbelakang berikutnya (\) bersifat opsional.

Huruf kandar, seperti "D:\"
Jalur ke titik pemasangan volume, seperti "c:\mnt\edrive\"
Pengidentifikasi volume unik (juga disebut nama GUID volume), seperti "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
Nama perangkat yang tidak konsisten (juga disebut nama target atau nama perangkat NT), seperti "\Device\HarddiskVolume1\"

Parameter ini diperlukan dan tidak boleh NULL.

[out] lpDosName

Penunjuk ke buffer yang dialokasikan pemanggil yang menerima nama perangkat MS-DOS sebagai string karakter lebar yang diakhiri NULL.

[in] dwDosNameBufferSize

Ukuran, dalam karakter lebar, dari buffer yang menunjuk lpDosName .

Nilai kembali

FilterGetDosName mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan nilai kesalahan.

Keterangan

FilterGetDosName mengembalikan huruf kandar volume jika memilikinya. Jika tidak ada huruf kandar yang ditetapkan ke volume, FilterGetDosName mengembalikan jalur ke titik pemasangan volume (juga disebut nama titik pemasangan). Jika tidak ada huruf kandar atau titik pemasangan yang ditentukan untuk volume, FilterGetDosName mengembalikan S_OK, dan lpDosName menerima NULL.