Fungsi FilterAttach (fltuser.h)

  • Artikel

Fungsi FilterAttach melampirkan instans minifilter baru ke volume yang diberikan.

Sintaks

HRESULT FilterAttach(
  [in]            LPCWSTR lpFilterName,
  [in]            LPCWSTR lpVolumeName,
  [in, optional]  LPCWSTR lpInstanceName,
  [in, optional]  DWORD   dwCreatedInstanceNameLength,
  [out, optional] LPWSTR  lpCreatedInstanceName
);

Parameter

[in] lpFilterName

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

[in] lpVolumeName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama volume tempat instans yang baru dibuat akan 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 lpVolumeName diperlukan dan tidak boleh NULL.

[in, optional] lpInstanceName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama instans untuk instans baru. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ADALAH NULL, instans baru menerima nama instans default minifilter seperti yang dijelaskan di bagian Keterangan untuk FltAttachVolume.

[in, optional] dwCreatedInstanceNameLength

Panjang, dalam byte, dari buffer yang ditunjuk lpCreatedInstanceName . Parameter ini bersifat opsional dan bisa nol.

[out, optional] lpCreatedInstanceName

Penunjuk ke variabel yang dialokasikan penelepon yang menerima nama instans untuk instans baru jika instans berhasil dilampirkan ke volume. Parameter ini bersifat opsional dan dapat berupa NULL. Jika bukan NULL, buffer harus cukup besar untuk menahan karakter INSTANCE_NAME_MAX_CHARS ditambah terminator NULL.

Nilai kembali

FilterAttach mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan nilai kesalahan seperti salah satu hal berikut ini.

Menampilkan kode Deskripsi
ERROR_FLT_INSTANCE_ALTITUDE_COLLISION
 Instans sudah ada di ketinggian ini pada volume yang ditentukan.
ERROR_FLT_INSTANCE_NAME_COLLISION
 Instans sudah ada dengan nama ini pada volume yang ditentukan.
ERROR_FILE_NOT_FOUND
 Jika lpInstanceNamenon-NULL, lpInstanceName tidak cocok dengan nama instans filter terdaftar di registri.

Keterangan

FilterAttach adalah Win32 yang setara dengan FltAttachVolume.

Nama instans yang ditentukan dalam lpInstanceName harus unik di seluruh sistem.

Untuk melampirkan instans minifilter ke volume pada ketinggian tertentu, panggil FilterAttachAtAltitude.

Untuk melepaskan instans minifilter dari volume, panggil FilterDetach.

Persyaratan

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

Lihat juga

FilterAttachAtAltitude

FilterDetach

FltAttachVolume