Compartir a través de


Función ComDBReleasePort (msports.h)

ComDBReleasePort libera un número de puerto COM en la base de datos de puertos COM.

Sintaxis

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

Parámetros

[in] HComDB

Identificador de la base de datos de puerto COM devuelta por ComDBOpen.

[in] ComNumber

Especifica el número de puerto COM que se va a liberar. Un número de puerto es un entero que va de uno a COMDB_MAX_PORTS_ARBITRATED.

Valor devuelto

ComDBReleasePort devuelve uno de los siguientes valores de estado.

Código devuelto Descripción
ERROR_SUCCESS
Se lanzó el número de puerto COM.
ERROR_CANTWRITE
La rutina no pudo escribir en la base de datos.
ERROR_INVALID_PARAMETER
Uno de los siguientes valores es true: el identificador especificado para la base de datos de puertos COM no es válido. El número de puerto especificado no está en la base de datos de puertos COM.
ERROR_NOT_CONNECTED
La rutina no pudo acceder a la base de datos. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Liberar un número de puerto COM significa registrar el número de puerto como "no en uso".

ComDBReleasePort se ejecuta en modo de usuario.

Para obtener más información, vea Obtener y liberar un número de puerto COM.

Requisitos

   
Plataforma de destino Escritorio
Encabezado msports.h (incluya Msports.h)
Library Msports.lib
Archivo DLL Msports.dll

Consulte también

ComDBClaimNextFreePort

ComDBClaimPort