ComDBClaimPort-Funktion (msports.h)

Artikel
02/29/2024

ComDBClaimPort protokolliert eine nicht verwendete COM-Portnummer als "verwendet" in der COM-Portdatenbank.

Syntax

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

Parameter

[in] HComDB

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

[in] ComNumber

Gibt an, welche COM-Portnummer der Aufrufer beansprucht. Eine Portnummer ist eine ganze Zahl, die zwischen 1 und COMDB_MAX_PORTS_ARBITRATED liegen kann.

[in] ForceClaim

Nur für die interne Verwendung vorgesehen.

[out, optional] Forced

Nur für die interne Verwendung vorgesehen.

Rückgabewert

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

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die COM-Portnummer wurde nicht verwendet und wird jetzt als "verwendet" protokolliert.
ERROR_CANTWRITE	Die Routine konnte nicht in die Datenbank schreiben.
ERROR_INVALID_PARAMETER	Eine der folgenden Punkte ist wahr: Das angegebene Handle für die COM-Portdatenbank ist ungültig. Die angegebene Portnummer ist größer als COMDB_MAX_PORTS_ARBITRATED.
ERROR_NOT_CONNECTED	Die Routine konnte nicht auf die Datenbank zugreifen. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
ERROR_SHARING_VIOLATION	Die angegebene Portnummer wird bereits verwendet.
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.

ComDBClaimPort wird im Benutzermodus ausgeführt.

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