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) 无效

In Use (6)

访问被拒绝 (40001)

没有足够的资源来完成操作。 (40002)

缓存过期 (40003)

磁盘尚未初始化。 (41000)

磁盘处于脱机状态。 (41003)

参数对于这种类型的分区无效。 (41006)

不允许对系统或关键分区执行该操作。 (42010)

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
命名空间 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

另请参阅

MSFT_Partition