ComDBResizeDatabase, fonction (msports.h)

Article
03/04/2024

ComDBResizeDatabase redimensionne la base de données de port COM.

Syntaxe

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

Paramètres

[in] HComDB

Gérez la base de données de port COM retournée par ComDBOpen.

[in] NewSize

Spécifie une nouvelle taille pour la base de données de ports COM, où la taille de la base de données correspond au nombre de numéros de port actuellement arbitrés dans la base de données. Cette valeur doit être un multiple entier de 1024, doit être supérieure à la taille actuelle et doit être inférieure ou égale à COMDB_MAX_PORTS_ARBITRATED.

Valeur retournée

ComDBResizeDatabase retourne l’une des valeurs status suivantes.

Code de retour	Description
ERROR_SUCCESS	La base de données a été redimensionnée avec succès.
ERROR_BAD_LENGTH	NewSize est inférieur ou égal à la taille actuelle de la base de données, ou supérieur à COMDB_MAX_PORTS_ARBITRATED.
ERROR_CANTWRITE	La routine n’a pas pu écrire dans la base de données.
ERROR_INVALID_PARAMETER	L’une des conditions suivantes est vraie : le handle spécifié pour la base de données de port COM n’est pas valide. NewSize n’est pas un multiple de 1024.
ERROR_NOT_CONNECTED	La routine n’a pas pu accéder à la base de données. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Utilisez ComDBGetCurrentPortUsage pour obtenir la taille de base de données actuelle.

ComDBResizeDatabase s’exécute en mode utilisateur.

Pour plus d’informations, consultez Redimensionnement de la base de données de ports COM.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	msports.h (inclure Msports.h)
Bibliothèque	Msports.lib
DLL	Msports.dll

Voir aussi

ComDBGetCurrentPortUsage

Partager via