Función FilterDetach (fltuser.h)
La función FilterDetach desasocia la instancia de minifiltro especificada del volumen especificado.
Sintaxis
HRESULT FilterDetach(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName
);
Parámetros
[in] lpFilterName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre del minifiltro cuya instancia se va a desasociar de la pila. Este parámetro es obligatorio y no puede ser NULL.
[in] lpVolumeName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre del volumen al que está asociada la instancia.
La cadena de entrada lpVolumeName puede ser cualquiera de las siguientes. La barra diagonal inversa final (\) es opcional.
- Una letra de unidad, como "D:\"
- Ruta de acceso a un punto de montaje de volumen, como "c:\mnt\edrive\"
- Un identificador de volumen único (también denominado nombre GUID de volumen), como "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- Un nombre de dispositivo no persistente (también denominado nombre de destino o un nombre de dispositivo NT), como "\Device\HarddiskVolume1\"
[in, optional] lpInstanceName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre de instancia de la instancia que se va a quitar. Este parámetro es opcional y puede ser NULL. Si es NULL, se quita la instancia coincidente más alta.
Valor devuelto
FilterDetach devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error.
Comentarios
FilterDetach es el equivalente win32 de FltDetachVolume.
FilterDetach desasocia una instancia de minifiltro de un volumen y desglosa la instancia.
Para adjuntar una instancia de minifiltro a un volumen, llame a FilterAttach o FilterAttachAtAltitude.
Requisitos
| Plataforma de destino | Universal |
| Encabezado | fltuser.h (incluya Fltuser.h) |
| Library | FltLib.lib |
| Archivo DLL | FltLib.dll |