compareVersion
Compare la version d'un fichier ou d'un paquetage avec la version d'un fichier ou d'un paquetage existant.
Méthode de
Objet InstallTrigger
Syntaxe
int compareVersion ( String registryName, InstallVersion version);
int compareVersion ( String registryName, String version);
int compareVersion ( String registryName, int major, int minor, int release, int build);
Paramètres
La méthode compareVersion
a les paramètres suivants :
-
registryName
-
Le nom du chemin d'accès dans la
Client Version Registry
du composant dont la version doit être comparée. Ce paramètre peut être un chemin absolu, tel que
/royalairways/RoyalSW
ou un chemin relatif, tel queplugsin/royalairway/RoyalSW
. Le nom du chemin d'accès dans le registre n'est pas l'emplacement du logiciel sur le disque dur de l'ordinateur. Il correspond au chemin d'accès vers les informations concernant le logiciel dans la Client Version Registry . -
version
- Un objet InstallVersion contenant les informations de version ou une chaîne au format majeur.mineur.version.compilation, où majeur, mineur, version et compilation sont des valeurs entières représentant les informations de version.
Retour
Si les versions sont identiques ou si l'installation de logiciels est désactivée, cette méthode retourne 0
. Si la version de registryName
est inférieure (plus ancienne) à version
, cette méthode retourne un nombre négatif. Autrement, cette méthode retourne un nombre positif. En particulier, cette méthode retourne l'une des valeurs suivantes :
-
-5
- Le composant n'est pas présent ou il n'est pas enregistré.
-
-4
-
registryName
a un numéro majeur plus petit (plus ancien) que le paramètreversion
. -
-3
-
registryName
a un numéro mineur plus petit (plus ancien) que le paramètreversion
. -
-2
-
registryName
a un numéro de version plus petit (plus ancien) que le paramètreversion
. -
-1
-
registryName
a un numéro de compilation plus petit (plus ancien) que le paramètreversion
. -
0
- Les numéros de version sont égaux ; les deux objets représentent la même version.
-
1
-
registryName
a un numéro de majeur plus grand (plus récent) que le paramètreversion
. -
2
-
registryName
a un numéro de mineur plus grand (plus récent) que le paramètreversion
. -
3
-
registryName
a un numéro de version plus grand (plus récent) que le paramètreversion
. -
4
-
registryName
a un numéro de compilation plus grand (plus récent) que le paramètreversion
.
Les constantes suivantes peuvent être utilisées pour vérifier la valeur retournée par compareVersion
:
- int MAJOR_DIFF = 4 ;
- int MINOR_DIFF = 3 ;
- int REL_DIFF = 2 ;
- int BLD_DIFF = 1 ;
- int EQUAL = 0.
Dans Communicator 4.5, les constantes suivantes sont définies et sont disponibles pour la vérification de la valeur retournée par compareVersion
:
InstallTrigger.MAJOR_DIFF
;InstallTrigger.MINOR_DIFF
;InstallTrigger.REL_DIFF
;InstallTrigger.BLD_DIFF
;InstallTrigger.EQUAL
.
Description
La méthode compareVersion
compare la version d'un fichier ou d'un paquetage installé avec la version spécifiée. Elle est souvent utilisée comme vérification avant l'initialisation du processus d'installation. Si registryName
n'est pas trouvé dans la
Client Version Registry
ou si registryName
n'a pas de version, registryName
est présumé avoir la version 0.0.0.0
. Si registryName
représente un fichier, compareVersion
vérifie l'existence du fichier. Si le fichier a été effacé, sa version est présumée être 0.0.0.0
.
Interwiki Languages Links