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)
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |