comDBReleasePort 函数 (msports.h)

ComDBReleasePort 释放 COM 端口数据库中的 COM 端口号。

语法

LONG ComDBReleasePort(
  [in] HCOMDB HComDB,
  [in] DWORD  ComNumber
);

parameters

[in] HComDB

ComDBOpen 返回的 COM 端口数据库的句柄。

[in] ComNumber

指定要发布的 COM 端口号。 端口号是一个整数,范围为 1 到 COMDB_MAX_PORTS_ARBITRATED。

返回值

ComDBReleasePort 返回以下状态值之一。

返回代码 说明
ERROR_SUCCESS
已释放 COM 端口号。
ERROR_CANTWRITE
例程无法写入数据库。
ERROR_INVALID_PARAMETER
下列情况之一为 true:COM 端口数据库的指定句柄无效。 指定的端口号不在 COM 端口数据库中。
ERROR_NOT_CONNECTED
例程无法访问数据库。 要获得更多的错误信息,请调用 GetLastError。

注解

释放 COM 端口号意味着将端口号记录为“未使用”。

ComDBReleasePort 在用户模式下运行。

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

要求

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

请参阅

ComDBClaimNextFreePort

ComDBClaimPort