Freigeben über


ComDBResizeDatabase-Funktion (msports.h)

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