Funzione ComDBClaimNextFreePort (msports.h)
ComDBClaimNextFreePort restituisce il numero di porta COM più basso che non è già in uso.
LONG ComDBClaimNextFreePort(
[in] HCOMDB HComDB,
[out] LPDWORD ComNumber
);
[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.
ComDBClaimNextFreePort restituisce uno dei valori di stato seguenti.
Codice restituito | Descrizione |
---|---|
|
La routine ha restituito correttamente un numero di porta COM. |
|
Impossibile scrivere la routine nel database. |
|
L'handle di database della porta COM specificato non è valido. |
|
Il database non può arbitare altri numeri di porta. |
|
La routine non è riuscita ad accedere al database. Per informazioni dettagliate sull'errore, chiamare GetLastError. |
|
Si è verificato un errore interno; chiamare GetLastError per ottenere informazioni di errore estese. |
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.
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | msports.h (include Msports.h) |
Libreria | Msports.lib |
DLL | Msports.dll |