Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ComDBResizeDatabase function

ComDBResizeDatabase resizes the COM port database.

Syntax


LONG WINAPI ComDBResizeDatabase(
  _In_  HCOMDB HComDB,
  _In_  DWORD NewSize
);

Parameters

HComDB [in]

Handle to the COM port database that was returned by ComDBOpen.

NewSize [in]

Specifies a new size for the COM port database, where the database size is the number of port numbers currently arbitrated in the database. This value must be an integer multiple of 1024, must be greater than the current size, and must be less than or equal to COMDB_MAX_PORTS_ARBITRATED.

Return value

ComDBResizeDatabase returns one of the following status values.

Return codeDescription
ERROR_SUCCESS

The database was successfully resized.

ERROR_BAD_LENGTH

NewSize is less than or equal to the current database size, or it is greater than COMDB_MAX_PORTS_ARBITRATED.

ERROR_CANTWRITE

The routine could not write to the database.

ERROR_INVALID_PARAMETER

One of the following is true: The specified handle to the COM port database is not valid. NewSize is not a multiple of 1024.

ERROR_NOT_CONNECTED

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

 

Remarks

Use ComDBGetCurrentPortUsage to obtain the current database size.

ComDBResizeDatabase runs in user mode.

For more information, see Resizing the COM Port Database.

Requirements

Header

Msports.h (include Msports.h)

Library

Msports.lib

DLL

Msports.dll

See also

ComDBGetCurrentPortUsage

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.