FilterDetach 函式 (fltuser.h)

FilterDetach函式會將指定的迷你篩選實例與指定的磁片區中斷連結。

語法

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

[in] lpFilterName

Null 終止寬字元字串的指標，其中包含要從堆疊卸離其實例的迷你篩選名稱。這個參數是必要的，而且不能是 Null。

[in] lpVolumeName

Null 終止寬字元字串的指標，其中包含實例目前附加的磁片區名稱。

lpVolumeName輸入字串可以是下列任一項。尾端反斜線 (\) 是選擇性的。

磁碟機號，例如「D：\」
磁片區掛接點的路徑，例如「c：\mnt\edrive\」
磁片區識別碼 (也稱為磁片區 GUID 名稱) ，例如「\？？\Volume{7603f260-142a-11d4-ac67-806d6172696f}\」
非持續性裝置名稱 (也稱為 目標名稱 或 NT 裝置名稱) ，例如「\Device\HarddiskVolume1\」

這個參數是必要的，而且不能是 Null。

[in, optional] lpInstanceName

Null 終止寬字元字串的指標，其中包含要移除之實例的實例名稱。這個參數是選擇性的，而且可以是 Null。如果是 Null，則會移除最高的相符實例。

如果成功，FilterDetach會傳回S_OK。否則，它會傳回錯誤值。

FilterDetach 是 Win32 相當於 FltDetachVolume。

FilterDetach 會從磁片區中斷連結迷你篩選實例，並卸載實例。

若要將迷你篩選實例附加至磁片區，請呼叫 FilterAttach 或 FilterAttachAtAltitude。