路径:支持库 → 基础支持库 → 磁盘。
硬约束
- 扁平命令;容量类返回值单位以签名说明为准(常见为字节)。
- 盘符参数格式以实现为准(如
"C:"/"C")。 - 移动设备插拔后列表可能变化,勿缓存过久。
- 失败时容量类命令可能返回 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:\\ 等形式,以签名为准 |
| 序列号当绝对唯一 | 部分机器可能为空/占位 |