Funzione FilterDetach (fltuser.h)

La funzione FilterDetach scollega l'istanza di minifilter specificata dal volume specificato.

Sintassi

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

Parametri

[in] lpFilterName

Puntatore a una stringa di caratteri wide-character con terminazione null contenente il nome del minifilter il cui istanza deve essere scollegata dallo stack. Questo parametro è obbligatorio e non può essere NULL.

[in] lpVolumeName

Puntatore a una stringa di caratteri wide-carattere con terminazione null contenente il nome del volume a cui è attualmente associata l'istanza.

La stringa di input lpVolumeName può essere una delle seguenti. La barra rovesciata finale (\) è facoltativa.

• Lettera di unità, ad esempio "D:\"
• Percorso di un punto di montaggio del volume, ad esempio "c:\mnt\edrive\"
• Identificatore di volume univoco (denominato anche nome GUID del volume), ad esempio "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
• Nome del dispositivo nonpersistent (chiamato anche nome di destinazione o nome di dispositivo NT), ad esempio "\Device\HarddiskVolume1\"

[in, optional] lpInstanceName

Puntatore a una stringa di caratteri wide-carattere con terminazione null contenente il nome dell'istanza da rimuovere. Questo parametro è facoltativo e può essere NULL. Se è NULL, l'istanza corrispondente più alta viene rimossa.

Valore restituito

FilterDetach restituisce S_OK se riuscito. In caso contrario, restituisce un valore di errore.

Commenti

FilterDetach è l'equivalente Win32 di FltDetachVolume.

FilterDetach scollega un'istanza di minifilter da un volume e rimuove l'istanza.

Per collegare un'istanza di minifilter a un volume, chiamare FilterAttach o FilterAttachAtAltitude.

Requisiti

Vedi anche

FilterAttach

FilterAttachAtAltitude

FltDetachVolume