FilterDetach-Funktion (fltuser.h)
Die FilterDetach-Funktion trennt den angegebenen Minifilter instance vom angegebenen Volume.
Syntax
HRESULT FilterDetach(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName
);
Parameter
[in] lpFilterName
Zeiger auf eine MIT NULL endende Breitzeichenzeichenfolge, die den Namen des Minifilters enthält, dessen instance vom Stapel getrennt werden soll. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[in] lpVolumeName
Zeiger auf eine MIT NULL endende Breitzeichenzeichenfolge, die den Namen des Volumes enthält, an das die instance derzeit angefügt ist.
Die Eingabezeichenfolge lpVolumeName kann wie folgt aussehen. Der nachfolgende umgekehrte Schrägstrich (\) ist optional.
- Ein Laufwerkbuchstabe, z. B. "D:\"
- Ein Pfad zu einem Volumebereitstellungspunkt, z. B. "c:\mnt\edrive\"
- Ein eindeutiger Volumebezeichner (auch als Volume-GUID-Name bezeichnet), z. B. "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- Ein nicht permanenter Gerätename (auch als Zielname oder NT-Gerätename bezeichnet), z. B. "\Device\HarddiskVolume1\"
[in, optional] lpInstanceName
Zeiger auf eine mit NULL endende Breitzeichenzeichenfolge, die den instance Namen für die zu entfernende instance enthält. Dieser Parameter ist optional und kann NULL sein. Wenn es NULL ist, wird die höchste übereinstimmende instance entfernt.
Rückgabewert
FilterDetach gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein Fehlerwert zurückgegeben.
Hinweise
FilterDetach ist die Win32-Entsprechung von FltDetachVolume.
FilterDetach trennt einen Minifilter instance von einem Volume und löscht die instance.
Um einen Minifilter instance an ein Volume anzufügen, rufen Sie FilterAttach oder FilterAttachAtAltitude auf.
Anforderungen
| Zielplattform | Universell |
| Header | fltuser.h (fltuser.h einschließen) |
| Bibliothek | FltLib.lib |
| DLL | FltLib.dll |