Función ComDBClaimNextFreePort (msports.h)

Artículo
03/05/2024

ComDBClaimNextFreePort devuelve el número de puerto COM más bajo que aún no está en uso.

Sintaxis

LONG ComDBClaimNextFreePort(
  [in]  HCOMDB  HComDB,
  [out] LPDWORD ComNumber
);

Parámetros

[in] HComDB

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

[out] ComNumber

Puntero al número de puerto COM que la rutina devuelve al autor de la llamada. Este puntero debe ser distinto de NULL. Un número de puerto es un entero que va de 1 a COMDB_MAX_PORTS_ARBITRATED.

Valor devuelto

ComDBClaimNextFreePort devuelve uno de los siguientes valores de estado.

Código devuelto	Descripción
ERROR_SUCCESS	La rutina devolvió correctamente un número de puerto COM.
ERROR_CANTWRITE	La rutina no pudo escribir en la base de datos.
ERROR_INVALID_PARAMETER	El identificador de base de datos de puerto COM especificado no es válido.
ERROR_NO_LOG_SPACE	La base de datos no puede arbitrar más números de puerto.
ERROR_NOT_CONNECTED	La rutina no pudo acceder a la base de datos. Para obtener información de error extendida, llame a GetLastError.
ERROR_Xxx	Error interno; llame a GetLastError para obtener información de error extendida.

Comentarios

La notificación de un número de puerto COM en la base de datos de puerto COM registra el número de puerto como "en uso". Tenga en cuenta que la base de datos no contiene información sobre el autor de la llamada o el dispositivo que reclama un número de puerto.

ComDBClaimNextFreePort se ejecuta en modo de usuario.

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