Funzione ComDBClaimPort (msport.h)

Articolo
02/29/2024

ComDBClaimPort registra un numero di porta COM inutilizzato come "in uso" nel database della porta COM.

Sintassi

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

Parametri

[in] HComDB

Gestire il database della porta COM restituito da ComDBOpen.

[in] ComNumber

Specifica il numero di porta COM che il chiamante tenta di richiedere. Un numero di porta è un numero intero che può variare da 1 a COMDB_MAX_PORTS_ARBITRATED.

[in] ForceClaim

Riservato esclusivamente per uso interno.

[out, optional] Forced

Riservato esclusivamente per uso interno.

Valore restituito

ComDBClaimPort restituisce uno dei valori di stato seguenti.

Codice restituito	Descrizione
ERROR_SUCCESS	Il numero di porta COM non era in uso ed è ora registrato come "in uso".
ERROR_CANTWRITE	Impossibile scrivere la routine nel database.
ERROR_INVALID_PARAMETER	Uno dei seguenti è true: l'handle specificato per il database della porta COM non è valido. Il numero di porta specificato è maggiore di COMDB_MAX_PORTS_ARBITRATED.
ERROR_NOT_CONNECTED	La routine non è riuscita ad accedere al database. Per informazioni dettagliate sull'errore, chiamare GetLastError.
ERROR_SHARING_VIOLATION	Il numero di porta specificato è già in uso.
ERROR_Xxx	Si è verificato un errore interno; chiamare GetLastError per ottenere informazioni sull'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 richiede un numero di porta.

ComDBClaimPort viene eseguito in modalità utente.

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