通过

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

返回代码 说明
ERROR_SUCCESS
 COM 端口号未使用，现在记录为“正在使用”。
ERROR_CANTWRITE
 例程无法写入数据库。
ERROR_INVALID_PARAMETER
 下列情况之一为 true：COM 端口数据库的指定句柄无效。 指定的端口号大于 COMDB_MAX_PORTS_ARBITRATED。
ERROR_NOT_CONNECTED
 例程无法访问数据库。 要获得更多的错误信息，请调用 GetLastError。
ERROR_SHARING_VIOLATION
 指定的端口号已在使用中。
ERROR_Xxx
 发生内部错误;调用 GetLastError 以获取扩展错误信息。

注解

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

ComDBClaimPort 在用户模式下运行。

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

要求

要求 值
目标平台 桌面
标头 msports.h (包括 Msports.h)
Library Msports.lib
DLL Msports.dll

另请参阅

ComDBClaimNextFreePort

ComDBReleasePort