该类对 WMI Win32_DiskDrive 类及其关联者:Win32_DiskDriveToDiskPartition 和 CIM_LogicalDiskBasedOnPartition 执行一系列查询,以检索系统(本地或远程)上活动 USB 驱动器上的信息。
这似乎是多余的(可能是因为它是多余的),因为您只是要求提供 USB 驱动器序列号。但是,您永远不知道下一步需要什么,它可能对其他人有用。
.Net Core 2.1(NuGet 包)需要Microsoft .Net System.Management 4.5
可以使用 Visual Studio NuGet Package Manager 轻松找到和安装。
关于Linux的支持,请看这里:
Windows Management Instrumentation Now A Formal Bus With Linux 4.13
另外,请留意Windows Compatibility Pack for .NET Core。
不断添加和更新新的跨平台程序集。
主类实现了所有必需的功能,并且结构非常简单。
WMI 查询使用关联语法,这是一种将 WMI 类对象相互关联的方法。
类属性的含义是不言自明的。
可以这样实例化:
SystemUSBDrives systemUSBDrives = new SystemUSBDrives("[Computer Name]");
当[Computer Name] 为空或为空时,它使用本地计算机名称。
要获取 USB 设备列表及其属性,请调用 GetUSBDrivesInfo() 方法:
var USBDrivesEnum = systemUSBDrives.GetUSBDrivesInfo([UserName], [Password], [Domain]);
[UserName], [Password], [Domain] 用于连接 NT 域。
这些参数如果不需要,可以为 null 或空字符串。
示例类实例化和函数调用 (Local Machine, no authentication):
SystemUSBDrives systemUSBDrives = new SystemUSBDrives(null);
var USBDrivesEnum = systemUSBDrives.GetUSBDrivesInfo(null, null, null);
测试于:
Visual Studio Pro 15.7.6 - 15.9.35
.Net Core 2.1 / .Net Framework 4.8
C# 6.0 -> 7.3
.Net System.Management 4.5
using System.Management;
public class SystemUSBDrives
{
string m_ComputerName = string.Empty;
public SystemUSBDrives(string ComputerName) {
this.m_ComputerName = string.IsNullOrEmpty(ComputerName)
? Environment.MachineName
: ComputerName;
}
private static EnumerationOptions GetEnumerationOptions(bool DeepScan)
{
var mOptions = new EnumerationOptions()
{
Rewindable = false, //Forward only query => no caching
ReturnImmediately = true, //Pseudo-async result
DirectRead = true,
EnumerateDeep = DeepScan
};
return mOptions;
}
private static ConnectionOptions GetConnectionOptions() => GetConnectionOptions("", "", "");
private static ConnectionOptions GetConnectionOptions(string userName, string password, string domain)
{
var connOptions = new ConnectionOptions()
{
EnablePrivileges = true,
Timeout = ManagementOptions.InfiniteTimeout,
Authentication = AuthenticationLevel.PacketPrivacy,
Impersonation = ImpersonationLevel.Impersonate,
Username = userName,
Password = password,
Authority = !string.IsNullOrEmpty(Domain) ? $"NTLMDOMAIN:{domain}" : string.Empty //Authority = "NTLMDOMAIN:[domain]"
};
return connOptions;
}
public List<USBDriveInfo> GetUSBDrivesInfo(string userName, string password, string domain)
{
var wmiQueryResult = new List<USBDriveInfo>();
ConnectionOptions connOptions = GetConnectionOptions(userName, password, domain);
EnumerationOptions mOptions = GetEnumerationOptions(false);
var mScope = new ManagementScope($@"\\{this.m_ComputerName}\root\CIMV2", connOptions);
var selQuery = new SelectQuery("SELECT * FROM Win32_DiskDrive WHERE InterfaceType='USB'");
mScope.Connect();
using (var moSearcher = new ManagementObjectSearcher(mScope, selQuery, mOptions)) {
foreach (ManagementObject moDiskDrive in moSearcher.Get()) {
var usbInfo = new USBDriveInfo();
usbInfo.GetDiskDriveInfo(moDiskDrive);
var relQuery = new RelatedObjectQuery(
$"Associators of {{Win32_DiskDrive.DeviceID='{moDiskDrive.Properties["DeviceID"].Value}'}} " +
$"WHERE AssocClass = Win32_DiskDriveToDiskPartition");
using (var moAssocPart = new ManagementObjectSearcher(mScope, relQuery, mOptions)) {
foreach (ManagementObject moAssocPartition in moAssocPart.Get()) {
usbInfo.GetDiskPartitionInfo(moAssocPartition);
relQuery = new RelatedObjectQuery(
$"Associators of {{Win32_DiskPartition.DeviceID='{moAssocPartition.Properties["DeviceID"].Value}'}} " +
$"WHERE AssocClass = CIM_LogicalDiskBasedOnPartition");
using (var moLogDisk = new ManagementObjectSearcher(mScope, relQuery, mOptions)) {
foreach (ManagementObject moLogDiskEnu in moLogDisk.Get()) {
usbInfo.GetLogicalDiskInfo(moLogDiskEnu);
moLogDiskEnu.Dispose();
}
}
moAssocPartition.Dispose();
}
wmiQueryResult.Add(usbInfo);
}
moDiskDrive.Dispose();
}
return wmiQueryResult;
}
} //GetUSBDrivesInfo()
public class USBDriveInfo
{
private int m_PartionsCount = 0;
public USBDriveInfo() => this.Partitions = new List<Partition>(1);
public string Caption { get; private set; }
public string DeviceID { get; private set; }
public string FirmwareRevision { get; private set; }
public ulong FreeSpace { get; private set; }
public string InterfaceType { get; private set; }
public bool MediaLoaded { get; private set; }
public string MediaType { get; private set; }
public string Model { get; private set; }
public uint NumberOfPartitions { get; private set; }
public List<Partition> Partitions { get; private set; }
public string PNPDeviceID { get; private set; }
public string SerialNumber { get; private set; }
public ulong Size { get; private set; }
public string Status { get; private set; }
public ulong TotalCylinders { get; private set; }
public uint TotalHeads { get; private set; }
public ulong TotalSectors { get; private set; }
public ulong TotalTracks { get; private set; }
public uint TracksPerCylinder { get; private set; }
public class Partition
{
public Partition() => this.LogicalDisks = new List<LogicalDisk>();
public bool Bootable { get; internal set; }
public bool BootPartition { get; internal set; }
public uint DiskIndex { get; internal set; }
public List<LogicalDisk> LogicalDisks { get; internal set; }
public ulong PartitionBlockSize { get; internal set; }
public ulong PartitionNumberOfBlocks { get; internal set; }
public ulong PartitionStartingOffset { get; internal set; }
public bool PrimaryPartition { get; internal set; }
}
public class LogicalDisk
{
public ulong FreeSpace { get; internal set; }
public string FileSystem { get; internal set; }
public string LogicalDiskVolume { get; internal set; }
public bool SupportsDiskQuotas { get; internal set; }
public string VolumeName { get; internal set; }
public string VolumeSerialNumber { get; internal set; }
}
internal void GetDiskDriveInfo(ManagementObject DiskDrive)
{
this.Caption = DiskDrive.GetPropertyValue("Caption")?.ToString();
this.DeviceID = DiskDrive["DeviceID"]?.ToString();
this.FirmwareRevision = DiskDrive["FirmwareRevision"]?.ToString();
this.InterfaceType = DiskDrive["InterfaceType"]?.ToString();
this.MediaLoaded = (bool?)DiskDrive["MediaLoaded"] ?? false;
this.MediaType = DiskDrive["MediaType"]?.ToString();
this.Model = DiskDrive["Model"]?.ToString();
this.NumberOfPartitions = (uint?)DiskDrive["Partitions"] ?? 0;
this.PNPDeviceID = DiskDrive["PNPDeviceID"]?.ToString();
this.SerialNumber = DiskDrive["SerialNumber"]?.ToString();
this.Size = (ulong?)DiskDrive["Size"] ?? 0L;
this.Status = DiskDrive["Status"]?.ToString();
this.TotalCylinders = (ulong?)DiskDrive["TotalCylinders"] ?? 0;
this.TotalHeads = (uint?)DiskDrive["TotalHeads"] ?? 0U;
this.TotalSectors = (ulong?)DiskDrive["TotalSectors"] ?? 0;
this.TotalTracks = (ulong?)DiskDrive["TotalTracks"] ?? 0;
this.TracksPerCylinder = (uint?)DiskDrive["TracksPerCylinder"] ?? 0;
}
internal void GetDiskPartitionInfo(ManagementObject Partitions)
{
m_PartionsCount += 1;
this.Partitions.Add(new Partition()
{
DiskIndex = (uint?)Partitions["DiskIndex"] ?? 0,
PartitionBlockSize = (ulong?)Partitions["BlockSize"] ?? 0,
Bootable = (bool?)Partitions["Bootable"] ?? false,
BootPartition = (bool?)Partitions["BootPartition"] ?? false,
PartitionNumberOfBlocks = (ulong?)Partitions["NumberOfBlocks"] ?? 0,
PrimaryPartition = (bool?)Partitions["PrimaryPartition"] ?? false,
PartitionStartingOffset = (ulong?)Partitions["StartingOffset"] ?? 0
});
}
internal void GetLogicalDiskInfo(ManagementObject LogicalDisk)
{
if (m_PartionsCount == 0) return;
this.Partitions[m_PartionsCount - 1].LogicalDisks.Add(new LogicalDisk()
{
FileSystem = LogicalDisk["FileSystem"]?.ToString(),
FreeSpace = (ulong?)LogicalDisk["FreeSpace"] ?? 0,
LogicalDiskVolume = LogicalDisk["DeviceID"]?.ToString(),
SupportsDiskQuotas = (bool?)LogicalDisk["SupportsDiskQuotas"] ?? false,
VolumeName = LogicalDisk["VolumeName"]?.ToString(),
VolumeSerialNumber = LogicalDisk["VolumeSerialNumber"]?.ToString()
});
//Linq's Sum() does not sum ulong(s)
foreach(Partition p in this.Partitions)
{
foreach (LogicalDisk ld in p.LogicalDisks) {
this.FreeSpace += ld.FreeSpace;
}
}
}
}
} // SystemUSBDrives