Partager via


ComDBReleasePort, fonction (msports.h)

ComDBReleasePort publie un numéro de port COM dans la base de données de ports COM.

Syntaxe

LONG ComDBReleasePort(
  [in] HCOMDB HComDB,
  [in] DWORD  ComNumber
);

Paramètres

[in] HComDB

Gérez la base de données de port COM retournée par ComDBOpen.

[in] ComNumber

Spécifie le numéro de port COM à libérer. Un numéro de port est un entier compris entre un et COMDB_MAX_PORTS_ARBITRATED.

Valeur retournée

ComDBReleasePort retourne l’une des valeurs status suivantes.

Code de retour Description
ERROR_SUCCESS
Le numéro de port COM a été libéré.
ERROR_CANTWRITE
La routine n’a pas pu écrire dans la base de données.
ERROR_INVALID_PARAMETER
L’une des conditions suivantes est vraie : le handle spécifié pour la base de données de port COM n’est pas valide. Le numéro de port spécifié n’est pas dans la base de données de ports COM.
ERROR_NOT_CONNECTED
La routine n’a pas pu accéder à la base de données. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

La publication d’un numéro de port COM signifie que le numéro de port est « non utilisé ».

ComDBReleasePort s’exécute en mode utilisateur.

Pour plus d’informations, consultez Obtention et publication d’un numéro de port COM.

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête msports.h (inclure Msports.h)
Bibliothèque Msports.lib
DLL Msports.dll

Voir aussi

ComDBClaimNextFreePort

ComDBClaimPort