winapi - How do I get a list of available serial ports in Win32?

Question

I have some legacy code that provides a list of the available COM ports on the PC by calling the EnumPorts() function and then filtering for the port names that start with "COM".

For testing purposes it would be very useful if I could use this code with something like com0com, which provides pairs of virtual COM ports looped together as a null-modem.

However the com0com ports are not found by the EnumPorts() function (even without filtering for "COM"). HyperTerminal and SysInternals PortMon can both see them, so I'm sure it is installed correctly.

So is there some other Win32 function that provides a definitive list of available serial ports?

Answer 1

The EnumSerialPorts v1.20 suggested by Nick D uses nine different methods to list the serial ports! We're certainly not short on choice, though the results seem to vary.

To save others the trouble, I'll list them here and indicate their success in finding the com0com ports on my PC (XP Pro SP2):

1. CreateFile("COM" + 1->255) as suggested by Wael Dalloul
   ✔ Found com0com ports, took 234ms.

2. QueryDosDevice()
   ✔ Found com0com ports, took 0ms.

3. GetDefaultCommConfig("COM" + 1->255)
   ✔ Found com0com ports, took 235ms.

4. "SetupAPI1" using calls to SETUPAPI.DLL
   ✔ Found com0com ports, also reported "friendly names", took 15ms.

5. "SetupAPI2" using calls to SETUPAPI.DLL
   ✘ Did not find com0com ports, reported "friendly names", took 32ms.

6. EnumPorts()
   ✘ Reported some non-COM ports, did not find com0com ports, took 15ms.

7. Using WMI calls
   ✔ Found com0com ports, also reported "friendly names", took 47ms.

8. COM Database using calls to MSPORTS.DLL
   ✔/✘ Reported some non-COM ports, found com0com ports, took 16ms.

9. Iterate over registry key HKEY_LOCAL_MACHINEHARDWAREDEVICEMAPSERIALCOMM
   ✔ Found com0com ports, took 0ms. This is apparently what SysInternals PortMon uses.

Based on those results I think the WMI method probably suits my requirements best as it is relatively fast and as a bonus it also gives the friendly names (e.g. "Communications Port (COM1)", "com0com - serial port emulator").