Partager via


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
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

Classes du système d’exploitation

Win32_Directory

Décompresser