Click here to Skip to main content
11,704,768 members (49,783 online)
Click here to Skip to main content

EnumSerialPorts v1.02 - Enumerating Serial Ports

, 3 Mar 2000 184.6K 4.5K 41
Rate this:
Please Sign up or sign in to vote.
A freeware MFC function to enumerate serial ports.
  • Download source files - 7 Kb
  • Introduction

    Welcome to EnumSerialPorts v1.01, a simple MFC function to enumerate the serial ports installed on your machine.


    Features
    Usage
    History
    API Reference
    Contacting the Author


    Features

    • Simple C style function interface.
    • The code works on both Windows 95/98 and NT.
    • The code is fully Unicode compliant and include Unicode built options in the workspace file.


    Usage

    • To use the function in your code simply #include "enumser.cpp" in your project and #include "enumser.h" in which ever of your modules needs to make calls to the function.
    • Your code will need to include MFC either statically or dynamically.
    • To see the class in action, have a look at the main function in the module main.cpp.


    History

    v1.0 (3 November 1998)
    • Initial Public release.

    v1.01 (23 February 1999)

    • Code now uses QueryDosDevice() if running on NT to determine which serial ports are available. This avoids having to open the ports at all. It should operate a lot faster in addition.

    V1.02 (12 December 1999)

    • Fixed a problem in the Win9x code path when trying to detect deactivated IRDA-ports. When trying to open those, you will get the error-code ERROR_GEN_FAILURE.


    API Reference

    EnumerateSerialPorts

    void ::EnumerateSerialPorts(CUIntArray& ports);

    Parameters:

    • ports -- Upon return this array will contain the port numbers of all the serial ports installed on the computer.



    Contacting the Author

    PJ Naughter
    Email: pjn@indigo.ie
    Web: http://www.naughter.com
    12 December 1999


    License

    This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

    A list of licenses authors might use can be found here

    Share

    About the Author

    PJ Naughter
    United States United States
    No Biography provided

    You may also be interested in...

    Comments and Discussions

     
    GeneralUintArray Pin
    drequinox4-Sep-06 10:44
    memberdrequinox4-Sep-06 10:44 
    GeneralProblem: Other devices starting with "Com"... Pin
    Supermagle11-Nov-05 3:03
    memberSupermagle11-Nov-05 3:03 
    GeneralRe: Problem: Other devices starting with "Com"... Pin
    Supermagle11-Nov-05 3:12
    memberSupermagle11-Nov-05 3:12 
    GeneralVIRTUAL SERIAL PORT Pin
    Joseph126-May-03 8:53
    memberJoseph126-May-03 8:53 
    GeneralRe: VIRTUAL SERIAL PORT Pin
    JLT7623-Feb-05 16:28
    memberJLT7623-Feb-05 16:28 
    GeneralSuggestion for another method Pin
    chris10919-Mar-02 3:03
    memberchris10919-Mar-02 3:03 
    Hi,

    I have found another method that I tested successfully on Windows 95 (should work on other windows platforms). It uses the EnumPorts function.
    (I took my inspiration from another author, Timothy J. Blue, http://multiverse.com/~mr.blue/enum_ports.html)

    int i;
    // pointer to port info struct
    PPORT_INFO_2 pInfo = NULL;
    // how many bytes needed to hold all port info
    DWORD dwNeeded = 0;
    // how many bytes filled after info is gotten
    DWORD dwReturned = 0;

    // Find out how much space is needed for pInfo
    EnumPorts(NULL, 2, (LPBYTE)pInfo, 0, &dwNeeded, &dwReturned);

    // allocate space for the port info
    pInfo = (PPORT_INFO_2)malloc(dwNeeded);
    if (pInfo == NULL) {
    // handle error...
    }
    else {
    EnumPorts (NULL, 2, (LPBYTE)pInfo, dwNeeded, &dwNeeded, &dwReturned);

    // loop through all the ports returned looking
    // for the type we want
    for (i = 0; i < (int)dwReturned; i++) {
    // We found a port!
    // If it is a serial port, its name is COMx
    if (strncmp(pInfo[i].pPortName, "COM", 3) == 0)
    fprintf(stderr, "%s\t%s\n",
    pInfo[i].pPortName,
    pInfo[i].pDescription);
    }

    // free space allocated for port info
    free(pInfo);
    pInfo = NULL;
    }





    Smile | :)

    Friendly yours, Chris
    GeneralThe way I do it ... Pin
    anonymous24-Aug-01 7:36
    memberanonymous24-Aug-01 7:36 
    GeneralIncorrect COM0 detection Pin
    Anonymous6-Aug-01 20:26
    memberAnonymous6-Aug-01 20:26 
    GeneralRe: Incorrect COM0 detection Pin
    Anonymous12-Aug-01 14:18
    memberAnonymous12-Aug-01 14:18 
    GeneralRe: Incorrect COM0 detection Pin
    Anonymous12-Aug-01 14:31
    memberAnonymous12-Aug-01 14:31 
    GeneralThere is a better way to enumerate ports... Pin
    Christian B25-Jul-01 1:15
    memberChristian B25-Jul-01 1:15 
    GeneralHelp for Windows CE Pin
    Chris Pichon19-May-01 5:48
    memberChris Pichon19-May-01 5:48 
    GeneralRe: Help for Windows CE Pin
    susilrani9-May-08 0:22
    membersusilrani9-May-08 0:22 
    Generali need to detect a modem . . . Pin
    guy19-Sep-00 5:37
    sussguy19-Sep-00 5:37 
    GeneralUse vector<UINT> instead of CUIntArray Pin
    leowlf9-Apr-00 16:22
    sussleowlf9-Apr-00 16:22 
    GeneralRe: Use vector<UINT> instead of CUIntArray Pin
    PJ Naughter16-May-00 13:57
    sussPJ Naughter16-May-00 13:57 
    GeneralRe: Use vector<UINT> instead of CUIntArray Pin
    Anonymous19-Apr-02 4:50
    memberAnonymous19-Apr-02 4:50 
    GeneralVirtual Ports Pin
    CMG4-Apr-00 12:06
    sussCMG4-Apr-00 12:06 
    GeneralRe: Virtual Ports Pin
    PJ Naughter5-Apr-00 11:46
    sussPJ Naughter5-Apr-00 11:46 
    GeneralRe: Virtual Ports Pin
    Eldad Kuperman12-Apr-00 23:25
    sussEldad Kuperman12-Apr-00 23:25 
    GeneralRe: Virtual Ports Pin
    Eldad Kuperman12-Apr-00 23:27
    sussEldad Kuperman12-Apr-00 23:27 
    GeneralRe: Virtual Ports Pin
    PJ Naughter16-May-00 14:00
    sussPJ Naughter16-May-00 14:00 
    GeneralRe: Virtual Ports Pin
    PJ Naughter17-May-00 3:13
    sussPJ Naughter17-May-00 3:13 
    GeneralRe: Virtual Ports Pin
    Gin Hwee2-Sep-01 21:52
    memberGin Hwee2-Sep-01 21:52 
    GeneralRe: Virtual Ports Pin
    Anonymous11-Dec-03 23:38
    sussAnonymous11-Dec-03 23:38 

    General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

    Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

    | Advertise | Privacy | Terms of Use | Mobile
    Web01 | 2.8.150819.1 | Last Updated 4 Mar 2000
    Article Copyright 2000 by PJ Naughter
    Everything else Copyright © CodeProject, 1999-2015
    Layout: fixed | fluid