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

Consulte también

FilterAttach

FilterAttachAtAltitude

FltDetachVolume