ComDBClaimNextFreePort-Funktion (msports.h)

Artikel
03/04/2024

ComDBClaimNextFreePort gibt die niedrigste COM-Portnummer zurück, die noch nicht verwendet wird.

Syntax

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

Parameter

[in] HComDB

Behandeln Sie die COM-Portdatenbank, die von ComDBOpen zurückgegeben wird.

[out] ComNumber

Zeiger auf die COM-Portnummer, die die Routine an den Aufrufer zurückgibt. Dieser Zeiger muss nicht NULL sein. Eine Portnummer ist eine ganze Zahl, die von 1 bis COMDB_MAX_PORTS_ARBITRATED reicht.

Rückgabewert

ComDBClaimNextFreePort gibt einen der folgenden status Werte zurück.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die Routine hat erfolgreich eine COM-Portnummer zurückgegeben.
ERROR_CANTWRITE	Die Routine konnte nicht in die Datenbank schreiben.
ERROR_INVALID_PARAMETER	Das angegebene COM-Port-Datenbankhandle ist ungültig.
ERROR_NO_LOG_SPACE	Die Datenbank kann keine weiteren Portnummern mehr auswerten.
ERROR_NOT_CONNECTED	Die Routine konnte nicht auf die Datenbank zugreifen. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
ERROR_Xxx	Ein interner Fehler ist aufgetreten. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Beim Anfordern einer COM-Portnummer in der COM-Portdatenbank wird die Portnummer als "in Verwendung" protokolliert. Beachten Sie, dass die Datenbank keine Informationen über den Aufrufer oder das Gerät enthält, das eine Portnummer beansprucht.

ComDBClaimNextFreePort wird im Benutzermodus ausgeführt.

Weitere Informationen finden Sie unter Abrufen und Freigeben einer COM-Portnummer.