ComDBClaimNextFreePort 函式 (msports.h)

ComDBClaimNextFreePort 會傳回尚未使用的最低 COM 埠號碼。

語法

LONG ComDBClaimNextFreePort(
  [in]  HCOMDB  HComDB,
  [out] LPDWORD ComNumber
);

[in] HComDB

ComDBOpen 所傳回之 COM 埠資料庫的句柄。

[out] ComNumber

例程傳回給呼叫端之 COM 埠號碼的指標。此指標必須是非 NULL。埠號碼是介於 1 到 COMDB_MAX_PORTS_ARBITRATED的整數。

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

傳回碼	Description
ERROR_SUCCESS	例程已成功傳回 COM 埠號碼。
ERROR_CANTWRITE	例程無法寫入資料庫。
ERROR_INVALID_PARAMETER	指定的 COM 埠資料庫句柄無效。
ERROR_NO_LOG_SPACE	資料庫無法再仲裁任何埠號碼。
ERROR_NOT_CONNECTED	例程無法存取資料庫。若要取得擴充的錯誤資訊，請呼叫 GetLastError。
ERROR_Xxx	發生內部錯誤;呼叫 GetLastError 以取得擴充的錯誤資訊。

宣告 COM 埠資料庫中的 COM 埠號碼會將埠號碼記錄為「使用中」。請注意，資料庫不包含宣告埠號碼之呼叫端或裝置的相關信息。

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

如需詳細資訊，請參閱取得和釋放 COM 埠號碼。