Fonction FilterDetach (fltuser.h)
La fonction FilterDetach détache le minifiltre donné instance du volume donné.
Syntaxe
HRESULT FilterDetach(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName
);
Paramètres
[in] lpFilterName
Pointeur vers une chaîne de caractères larges terminée par null contenant le nom du minifiltre dont le instance doit être détaché de la pile. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
[in] lpVolumeName
Pointeur vers une chaîne de caractères larges terminée par null contenant le nom du volume auquel le instance est actuellement attaché.
La chaîne d’entrée lpVolumeName peut être l’une des suivantes. La barre oblique inverse de fin (\) est facultative.
- Lettre de lecteur, telle que « D:\ »
- Chemin d’accès à un point de montage de volume, tel que « c:\mnt\edrive »
- Identificateur de volume unique (également appelé nom GUID de volume), tel que « \ ? » \Volume{7603f260-142a-11d4-ac67-806d6172696f}\
- Nom d’appareil non persistant (également appelé nom de cible ou nom d’appareil NT), tel que « \Device\HarddiskVolume1 »
[in, optional] lpInstanceName
Pointeur vers une chaîne de caractères larges terminée par null contenant le nom instance du instance à supprimer. Ce paramètre est facultatif et peut être NULL. S’il est NULL, le instance correspondant le plus élevé est supprimé.
Valeur retournée
FilterDetach retourne S_OK en cas de réussite. Sinon, il retourne une valeur d’erreur.
Notes
FilterDetach est l’équivalent Win32 de FltDetachVolume.
FilterDetach détache un minifiltre instance d’un volume et déchire le instance.
Pour attacher un minifiltre instance à un volume, appelez FilterAttach ou FilterAttachAtAltitude.
Spécifications
| Plateforme cible | Universal |
| En-tête | fltuser.h (inclure Fltuser.h) |
| Bibliothèque | FltLib.lib |
| DLL | FltLib.dll |