ComDBReleasePort-Funktion (msports.h)

ComDBReleasePort gibt eine COM-Portnummer in der COM-Portdatenbank frei.

Syntax

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

[in] HComDB

Handle für die COM-Portdatenbank, die von ComDBOpen zurückgegeben wurde.

[in] ComNumber

Gibt die com-Portnummer an, die freigegeben werden soll. Eine Portnummer ist eine ganze Zahl, die von 1 bis COMDB_MAX_PORTS_ARBITRATED reicht.

ComDBReleasePort gibt einen der folgenden status-Werte zurück.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die COM-Portnummer wurde freigegeben.
ERROR_CANTWRITE	Die Routine konnte nicht in die Datenbank schreiben.
ERROR_INVALID_PARAMETER	Eine der folgenden Werte ist richtig: Das angegebene Handle für die COM-Portdatenbank ist ungültig. Die angegebene Portnummer befindet sich nicht in der COM-Portdatenbank.
ERROR_NOT_CONNECTED	Die Routine konnte nicht auf die Datenbank zugreifen. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Das Freigeben einer COM-Portnummer bedeutet, dass die Portnummer als "nicht verwendet" protokolliert wird.

ComDBReleasePort wird im Benutzermodus ausgeführt.