共用方式為

ComDBClaimPort 函式 (msports.h)

  • 發行項

ComDBClaimPort 會將未使用的 COM 埠號碼記錄為 COM 埠資料庫中的「使用中」。

語法

LONG ComDBClaimPort(
  [in]            HCOMDB HComDB,
  [in]            DWORD  ComNumber,
  [in]            BOOL   ForceClaim,
  [out, optional] PBOOL  Forced
);

參數

[in] HComDB

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

[in] ComNumber

指定呼叫端嘗試宣告的 COM 埠號碼。 埠號碼是介於 1 到COMDB_MAX_PORTS_ARBITRATED的整數。

[in] ForceClaim

已保留供內部使用。

[out, optional] Forced

已保留供內部使用。

傳回值

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

傳回碼 Description
ERROR_SUCCESS
 COM 埠號碼未在使用中，現在會記錄為「使用中」。
ERROR_CANTWRITE
 例程無法寫入資料庫。
ERROR_INVALID_PARAMETER
 下列其中一項成立：COM 埠資料庫的指定句柄無效。 指定的埠號碼大於 COMDB_MAX_PORTS_ARBITRATED。
ERROR_NOT_CONNECTED
 例程無法存取資料庫。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
ERROR_SHARING_VIOLATION
 指定的埠號碼已在使用中。
ERROR_Xxx
 發生內部錯誤;呼叫 GetLastError 以取得擴充的錯誤資訊。

備註

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

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

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

規格需求

需求 值
目標平台 桌面
標頭 msports.h (包含 Msports.h)
程式庫 Msports.lib
Dll Msports.dll

另請參閱

ComDBClaimNextFreePort

ComDBReleasePort