共用方式為

FilterAttachAtAltitude 函式 (fltuser.h)

  • 發行項

FilterAttachAtAltitude函式是偵錯支援函式，會將新的迷你篩選實例附加至指定高度的磁片區，並覆寫迷你篩選程式設定資訊中的任何設定， (INF) 檔案。

語法

HRESULT FilterAttachAtAltitude(
  [in]            LPCWSTR lpFilterName,
  [in]            LPCWSTR lpVolumeName,
  [in]            LPCWSTR lpAltitude,
  [in, optional]  LPCWSTR lpInstanceName,
  [in, optional]  DWORD   dwCreatedInstanceNameLength,
  [out, optional] LPWSTR  lpCreatedInstanceName
);

參數

[in] lpFilterName

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

[in] lpVolumeName

Null 終止寬字元字串的指標，其中包含要附加新建立之實例的磁片區名稱。

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

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

[in] lpAltitude

Null 終止寬字元字串的指標，其中包含數值，指定迷你篩選實例在磁片區堆疊中應該佔用的目標位置。 數位愈高，堆疊中相對位置愈高。 高度字串包含範圍從 0 到 9 的一或多個數位，而且可以包含單一小數點。 小數點是選擇性的。 例如，「100.123456」 是有效的高度字串。 這個參數是必要的，而且不能是 Null。

[in, optional] lpInstanceName

Null 終止寬字元字串的指標，其中包含新實例的實例名稱。 這個參數是選擇性的，而且可以是 Null。 如果此參數為 Null，新實例會收到迷你篩選的預設實例名稱，如 FltAttachVolume的一節中所述。

[in, optional] dwCreatedInstanceNameLength

lpCreatedInstanceName指向的緩衝區長度，以位元組為單位。 這個參數是選擇性的，而且可以是零。

[out, optional] lpCreatedInstanceName

如果實例成功附加至磁片區，則呼叫端配置的變數會接收新實例的實例名稱的指標。 這個參數是選擇性的，而且可以是 Null。 如果不是 Null，緩衝區必須夠大，才能保存INSTANCE_NAME_MAX_CHARS字元加上 Null 結束字元。

傳回值

如果成功，FilterAttachAtAltitude會傳回S_OK。 否則，它會傳回錯誤值，例如下列其中一項。

傳回碼 描述
ERROR_FLT_INSTANCE_ALTITUDE_COLLISION
 實例已存在於指定的磁片區上這個高度。
ERROR_FLT_INSTANCE_NAME_COLLISION
 指定的磁片區上已有這個名稱的實例存在。

備註

應用程式應該只使用 FilterAttachAtAltitude 進行偵錯。 它不應該在應用程式的零售版本中呼叫此函式。

FilterAttachAtAltitude 是 Win32 相當於 FltAttachVolumeAtAltitude。

「高度」一詞是指實例佔用 (或應該佔用磁片區迷你篩選實例堆疊中) 的位置。 高度愈高，實例就愈遠于堆疊中的基底檔案系統。 在指定磁片區上的指定高度上，只能附加一個實例。

高度是由 高度字串所指定，這是寬字元陣列，其中包含介於 0 到 9 之間的一或多個十進位數，而且可以包含單一小數點。 小數點是選擇性的。 例如，「100.123456」 和 「03333」 是有效的高度字串。

字串 「03333」 代表比 「100.123456」 更高的高度。 (會忽略前置和尾端零。) 換句話說，高度為 「03333」 的實例比高度為 「100.123456」 的實例遠于基底檔案系統。 不過，只有在兩個實例都附加至相同的磁片區時，此比較才有意義。

在 lpCreatedInstanceName中傳回的實例名稱在整個系統中是唯一的。

若要從磁片區中斷連結迷你篩選實例，請呼叫 FilterDetach。

需求

   
目標平台 Universal
標頭 fltuser.h (包含 Fltuser.h)
程式庫 FltLib.lib
Dll FltLib.dll

另請參閱

FilterAttach

FilterDetach

FltAttachVolumeAtAltitude