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

Weitere Informationen

FilterAttach

FilterAttachAtAltitude

FltDetachVolume