Méthode Compress de la classe Win32_Directory
La méthode de classe Compress WMI compresse le fichier d’entrée de répertoire logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.
Syntaxe
uint32 Compress();
Paramètres
Cette méthode n’a aucun paramètre.
Valeur retournée
Retourne la valeur 0 (zéro) si le fichier a été correctement compressé et tout autre nombre pour indiquer une erreur.
-
0
-
La demande a abouti.
-
2
-
L’accès a été refusé.
-
8
-
Un échec non spécifié s’est produit.
-
9
-
Le nom spécifié n’était pas valide.
-
10
-
L’objet spécifié existe déjà.
-
11
-
Le système de fichiers n’est pas ntfs.
-
12
-
La plateforme n’est pas Windows.
-
13
-
Le lecteur n’est pas le même.
-
14
-
Le répertoire n'est pas vide.
-
15
-
Il y a eu une violation du partage.
-
16
-
Le fichier de démarrage spécifié n’était pas valide.
-
17
-
Un privilège requis pour l’opération n’est pas conservé.
-
21
-
Un paramètre spécifié n’est pas valide.
Notes
La compression permet de libérer de l’espace de stockage supplémentaire sur un lecteur de disque sans acheter de nouveau matériel et sans supprimer de fichiers ou de dossiers. En fonction de la taille de votre disque dur et du type de fichiers stockés sur ce disque, vous pouvez récupérer des centaines de mégaoctets d’espace disque et ainsi éviter d’avoir à acheter un nouveau disque dur et à mettre l’ordinateur hors connexion jusqu’à ce que le nouveau lecteur soit installé.
La méthode Compress compresse tous les fichiers et sous-dossiers dans un dossier spécifié. En outre, la classe inclut également une méthode Uncompress qui supprime la compression de tous les fichiers et sous-dossiers d’un dossier. Des méthodes similaires sont également fournies avec la classe CIM_Datafile. Cela vous permet de compresser ou de décompresser de manière sélective des fichiers spécifiques dans un dossier.
Étant donné que la compression génère une légère pénalité de performances, elle n’est pas recommandée pour les fichiers ou dossiers auxquels on accède régulièrement ; par exemple, vous ne souhaitez probablement pas compresser les fichiers de base de données, les fichiers journaux ou les dossiers de profil utilisateur. Les meilleurs candidats à la compression sont les fichiers et dossiers qui ne sont pas consultés très souvent. Par exemple, vous pouvez écrire un script pour retourner une collection de dossiers sur un lecteur qui n’ont pas été consultés depuis un mois ou plus, puis compresser chacun de ces dossiers.
La quantité d’espace disque libérée par la compression des dossiers varie en fonction du type de fichiers stockés dans ce dossier. Par exemple, .jpg fichiers sont déjà compressés et une compression supplémentaire a peu d’effet sur la taille du fichier. Toutefois, avec d’autres types de fichiers, les économies peuvent être considérables. Par exemple, un nouveau dossier a été créé sur un ordinateur de test Windows 2000, et 33 documents Microsoft Word, qui occupent un total de 15 mégaoctets (Mo) d’espace disque, ont été copiés dans ce dossier. Lorsque les documents ont été compressés, le dossier ne prenait que 7 Mo d’espace disque.
Exemples
L’exemple VBScript suivant compresse le dossier C:\Scripts.
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery _
("SELECT * FROM Win32_Directory WHERE Name = 'c:\\Scripts'")
For Each objFolder in colFolders
errResults = objFolder.Compress
Wscript.Echo errResults
Next
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|