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

Voir aussi

FilterAttach

FilterAttachAtAltitude

FltDetachVolume