Funzione ComDBClaimNextFreePort (msports.h)

Articolo
02/29/2024

ComDBClaimNextFreePort restituisce il numero di porta COM più basso che non è già in uso.

Sintassi

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

Parametri

[in] HComDB

Gestire il database della porta COM restituito da ComDBOpen.

[out] ComNumber

Puntatore al numero di porta COM restituito dalla routine al chiamante. Questo puntatore deve essere diverso da NULL. Un numero di porta è un numero intero compreso tra 1 e COMDB_MAX_PORTS_ARBITRATED.

Valore restituito

ComDBClaimNextFreePort restituisce uno dei valori di stato seguenti.

Codice restituito	Descrizione
ERROR_SUCCESS	La routine ha restituito correttamente un numero di porta COM.
ERROR_CANTWRITE	Impossibile scrivere la routine nel database.
ERROR_INVALID_PARAMETER	L'handle di database della porta COM specificato non è valido.
ERROR_NO_LOG_SPACE	Il database non può arbitare altri numeri di porta.
ERROR_NOT_CONNECTED	La routine non è riuscita ad accedere al database. Per informazioni dettagliate sull'errore, chiamare GetLastError.
ERROR_Xxx	Si è verificato un errore interno; chiamare GetLastError per ottenere informazioni di errore estese.

Commenti

La richiesta di un numero di porta COM nel database della porta COM registra il numero di porta come "in uso". Si noti che il database non contiene informazioni sul chiamante o sul dispositivo che attestazione un numero di porta.

ComDBClaimNextFreePort viene eseguito in modalità utente.

Per altre informazioni, vedere Ottenere e rilasciare un numero di porta COM.