Fungsi FilterDetach (fltuser.h)

Artikel
03/09/2023

Fungsi FilterDetach melepaskan instans minifilter yang diberikan dari volume yang diberikan.

Sintaks

HRESULT FilterDetach(
  [in]           LPCWSTR lpFilterName,
  [in]           LPCWSTR lpVolumeName,
  [in, optional] LPCWSTR lpInstanceName
);

Parameter

[in] lpFilterName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama minifilter yang instansnya akan dilepas dari tumpukan. Parameter ini diperlukan dan tidak boleh NULL.

[in] lpVolumeName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama volume tempat instans saat ini dilampirkan.

String input lpVolumeName dapat berupa salah satu dari berikut ini. Garis miring terbelakang (\) 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.

[in, optional] lpInstanceName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama instans untuk instans yang akan dihapus. Parameter ini bersifat opsional dan dapat berupa NULL. Jika NULL, instans pencocokan tertinggi akan dihapus.

Menampilkan nilai

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

Keterangan

FilterDetach setara dengan Win32 dari FltDetachVolume.

FilterDetach melepaskan instans minifilter dari volume dan merobek instans.

Untuk melampirkan instans minifilter ke volume, panggil FilterAttach atau FilterAttachAtAltitude.

Persyaratan


Target Platform	Universal
Header	fltuser.h (termasuk Fltuser.h)
Pustaka	FltLib.lib
DLL	FltLib.dll

Lihat juga

FilterAttach

FilterAttachAtAltitude

FltDetachVolume

Bagikan melalui