comDBResizeDatabase 函式 (msports.h)

ComDBResizeDatabase 會調整 COM 埠資料庫的大小。

語法

LONG ComDBResizeDatabase(
  [in] HCOMDB HComDB,
  [in] DWORD  NewSize
);

[in] HComDB

處理 ComDBOpen 所傳回的 COM 埠資料庫。

[in] NewSize

指定 COM 埠資料庫的新大小，其中資料庫大小是資料庫中目前仲裁的埠號碼數目。這個值必須是 1024 的整數倍數、必須大於目前的大小，而且必須小於或等於COMDB_MAX_PORTS_ARBITRATED。

ComDBResizeDatabase 會傳回下列其中一個狀態值。

傳回碼	Description
ERROR_SUCCESS	資料庫已成功重設大小。
ERROR_BAD_LENGTH	NewSize 小於或等於目前的資料庫大小，或大於COMDB_MAX_PORTS_ARBITRATED。
ERROR_CANTWRITE	例程無法寫入資料庫。
ERROR_INVALID_PARAMETER	下列其中一項成立：COM 埠資料庫的指定句柄無效。 NewSize 不是 1024 的倍數。
ERROR_NOT_CONNECTED	例程無法存取資料庫。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

使用 ComDBGetCurrentPortUsage 來取得目前的資料庫大小。

ComDBResizeDatabase 會在使用者模式中執行。

如需詳細資訊，請參閱調整 COM 埠資料庫的大小。