Export (0) Print
Expand All

ComDBOpen function

ComDBOpen returns a handle to the COM port database.

Syntax


LONG WINAPI ComDBOpen(
  _Out_  PHCOMDB PHComDB
);

Parameters

PHComDB [out]

Pointer, if the routine succeeds, to a handle to the COM port database. Otherwise, the routine sets *PHComDB to HCOMDB_INVALID_HANDLE_VALUE. PHComDB must be non-NULL.

Return value

ComDBOpen returns one of the following status values.

Return codeDescription
ERROR_SUCCESS

The COM port database was successfully opened.

ERROR_ACCESS_DENIED

The routine could not open the database. To get extended error information, call GetLastError.

 

Remarks

To close the COM port database, call ComDBClose and supply the handle that was returned by ComDBOpen.

ComDBOpen is called from user mode.

For more information, see Opening and Closing the COM Port Database.

Requirements

Header

Msports.h (include Msports.h)

Library

Msports.lib

DLL

Msports.dll

See also

ComDBClose

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft