ComDBResizeDatabase-Funktion (msports.h)

Artikel
02/29/2024

ComDBResizeDatabase ändert die Größe der COM-Portdatenbank.

Syntax

LONG ComDBResizeDatabase(
  [in] HCOMDB HComDB,
  [in] DWORD  NewSize
);

Parameter

[in] HComDB

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

[in] NewSize

Gibt eine neue Größe für die COM-Portdatenbank an, bei der die Datenbankgröße die Anzahl der Portnummern entspricht, die derzeit in der Datenbank festgelegt werden. Dieser Wert muss ein ganzzahliges Vielfaches von 1024 sein, muss größer als die aktuelle Größe und kleiner oder gleich COMDB_MAX_PORTS_ARBITRATED sein.

Rückgabewert

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

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die Größe der Datenbank wurde erfolgreich geändert.
ERROR_BAD_LENGTH	NewSize ist kleiner oder gleich der aktuellen Datenbankgröße oder größer als COMDB_MAX_PORTS_ARBITRATED.
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. NewSize ist kein Vielfaches von 1024.
ERROR_NOT_CONNECTED	Die Routine konnte nicht auf die Datenbank zugreifen. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Verwenden Sie ComDBGetCurrentPortUsage , um die aktuelle Datenbankgröße abzurufen.

ComDBResizeDatabase wird im Benutzermodus ausgeführt.

Weitere Informationen finden Sie unter Ändern der Größe der COM-Portdatenbank.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	msports.h (include Msports.h)
Bibliothek	Msports.lib
DLL	Msports.dll

Weitere Informationen

ComDBGetCurrentPortUsage

Freigeben über