Função FilterDetach (fltuser.h)

A função FilterDetach desanexa a instância de minifiltro fornecida do volume determinado.

Sintaxe

HRESULT FilterDetach(
  [in]           LPCWSTR lpFilterName,
  [in]           LPCWSTR lpVolumeName,
  [in, optional] LPCWSTR lpInstanceName
);

Parâmetros

[in] lpFilterName

Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome do minifiltro cuja instância deve ser desanexada da pilha. Esse parâmetro é necessário e não pode ser NULL.

[in] lpVolumeName

Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome do volume ao qual a instância está anexada no momento.

A cadeia de caracteres de entrada lpVolumeName pode ser qualquer uma das seguintes. A barra invertida à direita (\) é opcional.

• Uma letra da unidade, como "D:\"
• Um caminho para um ponto de montagem de volume, como "c:\mnt\edrive\"
• Um identificador de volume exclusivo (também chamado de nome GUID do volume), como "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
• Um nome de dispositivo não persistente (também chamado de nome de destino ou nome de dispositivo NT), como "\Device\HarddiskVolume1\"

Esse parâmetro é necessário e não pode ser NULL.

[in, optional] lpInstanceName

Ponteiro para uma cadeia de caracteres largos terminada em nulo que contém o nome da instância para a instância a ser removida. Esse parâmetro é opcional e pode ser NULL. Se for NULL, a instância correspondente mais alta será removida.

Valor retornado

FilterDetach retornará S_OK se tiver êxito. Caso contrário, ele retornará um valor de erro.

Comentários

FilterDetach é o equivalente a Win32 de FltDetachVolume.

FilterDetach desanexa uma instância de minifiltro de um volume e remove a instância.

Para anexar uma instância de minifiltro a um volume, chame FilterAttach ou FilterAttachAtAltitude.

Requisitos

Plataforma de Destino	Universal
Cabeçalho	fltuser.h (inclua Fltuser.h)
Biblioteca	FltLib.lib
DLL	FltLib.dll

Confira também

FilterAttach

FilterAttachAtAltitude

FltDetachVolume