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 返回以下状态值之一。

返回代码	说明
ERROR_SUCCESS	例程已成功返回 COM 端口号。
ERROR_CANTWRITE	例程无法写入数据库。
ERROR_INVALID_PARAMETER	指定的 COM 端口数据库句柄无效。
ERROR_NO_LOG_SPACE	数据库无法再仲裁任何端口号。
ERROR_NOT_CONNECTED	例程无法访问数据库。要获得更多的错误信息，请调用 GetLastError。
ERROR_Xxx	发生内部错误;调用 GetLastError 以获取扩展错误信息。

在 COM 端口数据库中声明 COM 端口号会将端口号记录为“正在使用”。请注意，数据库不包含有关声明端口号的调用方或设备的信息。

ComDBClaimNextFreePort 在用户模式下运行。

有关详细信息，请参阅获取和释放 COM 端口号。