MSFT_Partition 類別的 SetAttributes 方法

設定分割區的各種屬性和屬性。

語法

UInt32 SetAttributes(
  [in]  Boolean IsReadOnly,
  [in]  Boolean NoDefaultDriveLetter,
  [in]  Boolean IsActive,
  [in]  Boolean IsHidden,
  [out] String  ExtendedStatus
);

參數

IsReadOnly [in]

如果 為 TRUE，則會將分割區設為唯讀。 如果為 FALSE，則會將分割區設為可寫入。

NoDefaultDriveLetter [in]

如果 為 TRUE，則當探索到磁碟分區時，操作系統不會自動指派驅動器號。 這僅適用於 GPT 磁碟，並假設 MBR 磁碟為 FALSE 。 這個屬性在存放區域網路 (SAN) 環境中很有用。

IsActive [in]

如果 分割區是作用中且可用來啟動系統的 MBR 磁碟分區，則為 TRUE。 這個參數只和 MBR 磁碟相關。

IsHidden [in]

如果 掛接管理員未偵測到分割區，則為TRUE。 因此，磁碟分區不會收到驅動器號、未接收磁碟區 GUID 路徑、未裝載磁碟區裝入點，而且不會透過 呼叫 FindFirstVolume 和 FindNextVolume 來列舉。 這可確保應用程式 (例如磁碟重組工具) 不會存取磁碟分割。 磁碟區陰影複製服務 (VSS) 在其陰影複製上使用此屬性。

ExtendedStatus [out]

包含內嵌 MSFT_StorageExtendedStatus 物件的字串。

此參數可讓儲存提供者傳回擴充 (實作特定) 錯誤資訊。

傳回值

成功 (0)

不支援 (1)

未指定的錯誤 (2)

逾 時 (3)

失敗 (4)

無效的參數 (5)

在 [使用 (6)

(40001) 拒絕存取

沒有足夠的資源可完成作業。 (40002)

快取過期 (40003)

磁碟尚未初始化。 (41000)

磁碟已離線。 (41003)

參數對這種類型的數據分割無效。 (41006)

系統或關鍵分割區上不允許此作業。 (42010)

規格需求

另請參閱

MSFT_Partition