Fungsi FltGetVolumeFromName (fltkernel.h)

Artikel
08/07/2023

Rutinitas FltGetVolumeFromName mengembalikan pointer buram untuk volume yang namanya cocok dengan nilai parameter VolumeName .

Sintaks

NTSTATUS FLTAPI FltGetVolumeFromName(
  [in]  PFLT_FILTER      Filter,
  [in]  PCUNICODE_STRING VolumeName,
  [out] PFLT_VOLUME      *RetVolume
);

Parameter

[in] Filter

Penunjuk filter buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] VolumeName

Penunjuk ke struktur UNICODE_STRING yang berisi nama volume (misalnya, "\Device\HarddiskVolume1", "\DosDevices\D:", "\?? \D:", atau "D:"). Parameter ini diperlukan dan tidak boleh NULL.

[out] RetVolume

Penunjuk ke variabel yang dialokasikan penelepon yang menerima pointer buram untuk volume. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FltGetVolumeFromName mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai, seperti salah satu dari berikut ini:

Menampilkan kode	Deskripsi
STATUS_ACCESS_DENIED	Penelepon tidak memiliki akses FILE_READ_DATA ke volume. Ini adalah kode kesalahan.
STATUS_FLT_DELETING_OBJECT	Volume sedang dicabik-cabik. Ini adalah kode kesalahan.
STATUS_INVALID_PARAMETER	Nilai yang tidak valid ditentukan untuk parameter VolumeName . Ini adalah kode kesalahan.
STATUS_FLT_VOLUME_NOT_FOUND	Tidak ditemukan volume yang cocok. Ini adalah kode kesalahan.

Keterangan

FltGetVolumeFromName mencari daftar volume global Manajer Filter untuk volume yang namanya cocok dengan VolumeName. Penelepon harus memiliki akses FILE_READ_DATA ke volume. Untuk menemukan struktur volume, FltGetVolumeFromName harus terlebih dahulu membuka volume.

FltGetVolumeFromName menambahkan referensi rundown ke pointer volume buram yang dikembalikan dalam parameter RetVolume . Ketika pointer ini tidak lagi diperlukan, pemanggil harus melepaskannya dengan memanggil FltObjectDereference. Dengan demikian setiap panggilan yang berhasil ke FltGetVolumeFromName harus dicocokkan dengan panggilan berikutnya ke FltObjectDereference.

Untuk mendapatkan nama volume untuk volume tertentu, panggil FltGetVolumeName.

Untuk mendapatkan nama GUID volume untuk volume tertentu, panggil FltGetVolumeGuidName.