Función ComDBClaimPort (msports.h)

Artículo
02/29/2024

ComDBClaimPort registra un número de puerto COM sin usar como "en uso" en la base de datos de puertos COM.

Sintaxis

LONG ComDBClaimPort(
  [in]            HCOMDB HComDB,
  [in]            DWORD  ComNumber,
  [in]            BOOL   ForceClaim,
  [out, optional] PBOOL  Forced
);

Parámetros

[in] HComDB

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

[in] ComNumber

Especifica el número de puerto COM que el autor de la llamada intenta reclamar. Un número de puerto es un entero que puede oscilar entre 1 y COMDB_MAX_PORTS_ARBITRATED.

[in] ForceClaim

Reservado para uso interno.

[out, optional] Forced

Reservado para uso interno.

Valor devuelto

ComDBClaimPort devuelve uno de los siguientes valores de estado.

Código devuelto	Descripción
ERROR_SUCCESS	El número de puerto COM no estaba en uso y ahora se registra como "en uso".
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 es mayor que COMDB_MAX_PORTS_ARBITRATED.
ERROR_NOT_CONNECTED	La rutina no pudo acceder a la base de datos. Para obtener información de error extendida, llame a GetLastError.
ERROR_SHARING_VIOLATION	El número de puerto especificado ya está en uso.
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.

ComDBClaimPort se ejecuta en modo de usuario.

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