YStudio Y++

磁盘(基础支持库)

Y++ / YStudio 开发文档 · 一点滴

路径:支持库 → 基础支持库 → 磁盘。

硬约束

  1. 扁平命令;容量类返回值单位以签名说明为准(常见为字节)。
  2. 盘符参数格式以实现为准(如 "C:" / "C")。
  3. 移动设备插拔后列表可能变化,勿缓存过久。
  4. 失败时容量类命令可能返回 0 或 -1,以说明为准。

快速开始

输出(取磁盘剩余空间("C:\\"))
输出(取磁盘使用率("C:\\"))
输出(取硬盘物理序列号(0))

磁盘操作

本分类共 9 条。

取主板序列号

  • 签名:文本 取主板序列号()
  • 说明:通过 WMI 依次尝试主板/BIOS/机箱/产品标识及 UUID,并跳过常见占位串(如 Default string、Standard 等)。若 BIOS 仅上报占位值属硬件常见情况;此时函数会尽量返回可用的系统 UUID。

取硬盘物理序列号

  • 签名:文本 取硬盘物理序列号([整数 磁盘序号=0])
  • 说明:通过 WMI 读取物理磁盘序列号(系统窗口_DiskDrive)。diskIndex 为 WMI 中的 Index 字段,通常为 0 表示第一块物理盘。
  • 参数一│[磁盘序号=0]: 对应 系统窗口_DiskDrive.Index

取磁盘使用率

  • 签名:小数 取磁盘使用率(文本 磁盘路径)
  • 说明:获取指定磁盘的使用率百分比
  • 参数一│磁盘路径: 磁盘路径

取磁盘列表

  • 签名:数组 取磁盘列表()
  • 说明:获取系统中所有磁盘驱动器列表

取磁盘可用空间

  • 签名:整数 取磁盘可用空间(文本 磁盘路径)
  • 说明:获取指定磁盘的可用空间(字节)
  • 参数一│磁盘路径: 磁盘路径,如 C:\ 或 /

取磁盘已用空间

  • 签名:整数 取磁盘已用空间(文本 磁盘路径)
  • 说明:获取指定磁盘的已用空间(字节)
  • 参数一│磁盘路径: 磁盘路径

取磁盘总容量

  • 签名:整数 取磁盘总容量(文本 磁盘路径)
  • 说明:获取指定磁盘的总容量(字节)
  • 参数一│磁盘路径: 磁盘路径,如 C:\ 或 /

取磁盘类型

  • 签名:整数 取磁盘类型(文本 磁盘路径)
  • 说明:获取指定磁盘的类型整数码。返回值含义:0=未知,1=路径无效,2=可移动磁盘,3=固定磁盘,4=网络磁盘,5=光驱,6=RAM磁盘。
  • 参数一│磁盘路径: 磁盘路径,如 “C:\“

磁盘是否就绪

  • 签名:逻辑 磁盘是否就绪(文本 磁盘路径)
  • 说明:检查指定磁盘是否准备就绪
  • 参数一│磁盘路径: 磁盘路径

易错对照

错误 正确
盘符格式写错 用 C:\\ 等形式,以签名为准
序列号当绝对唯一 部分机器可能为空/占位

相关

系统操作 · 文件操作