Compress-Methode der Win32_Directory-Klasse
Die CompressWMI-Klassenmethode komprimiert die logische Verzeichniseintragsdatei (oder das Verzeichnis), die im Objektpfad angegeben ist.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 Compress();
Parameter
Diese Methode hat keine Parameter.
Rückgabewert
Gibt den Wert 0 (null) zurück, wenn die Datei erfolgreich komprimiert wurde, und eine beliebige andere Zahl, die auf einen Fehler hinweist.
-
0
-
Die Anforderung wurde erfolgreich gesendet.
-
2
-
Der Zugriff wurde verweigert.
-
8
-
Ein nicht angegebener Fehler ist aufgetreten.
-
9
-
Der angegebene Name war ungültig.
-
10
-
Das angegebene Objekt ist bereits vorhanden.
-
11
-
Das Dateisystem ist kein NTFS.The file system is not an NTFS.
-
12
-
Die Plattform ist nicht Windows.
-
13
-
Das Laufwerk ist nicht identisch.
-
14
-
Das Verzeichnis ist nicht leer.
-
15
-
Es ist ein Verstoß gegen die Freigabe aufgetreten.
-
16
-
Die angegebene Startdatei war ungültig.
-
17
-
Eine für den Vorgang erforderliche Berechtigung wird nicht gehalten.
-
21
-
Ein angegebener Parameter ist ungültig.
Bemerkungen
Die Komprimierung bietet eine Möglichkeit, zusätzlichen Speicherplatz auf einem Datenträger frei zu geben, ohne neue Hardware zu erwerben und ohne Dateien oder Ordner zu entfernen. Abhängig von der Größe Ihrer Festplatte und der Art der auf diesem Datenträger gespeicherten Dateien können Sie möglicherweise Hunderte von Megabyte Speicherplatz wiederherstellen und somit die Notwendigkeit ausschließen, eine neue Festplatte zu erwerben und den Computer offline zu schalten, bis das neue Laufwerk installiert ist.
Die Compress-Methode komprimiert alle Dateien und Unterordner in einem angegebenen Ordner. Darüber hinaus enthält die -Klasse auch eine Uncompress-Methode, die die Komprimierung aus allen Dateien und Unterordnern in einem Ordner entfernt. Ähnliche Methoden werden auch mit der CIM_Datafile-Klasse bereitgestellt. Dadurch können Sie bestimmte Dateien in einem Ordner selektiv komprimieren oder dekomprimieren.
Da die Komprimierung eine leichte Leistungseinbuße mit sich führt, wird dies nicht für Dateien oder Ordner empfohlen, auf die routinemäßig zugegriffen wird. Sie möchten beispielsweise wahrscheinlich keine Datenbankdateien, Protokolldateien oder Benutzerprofilordner komprimieren. Bessere Kandidaten für die Komprimierung sind Dateien und Ordner, auf die nicht sehr häufig zugegriffen wird. Sie können beispielsweise ein Skript schreiben, um eine Sammlung von Ordnern auf einem Laufwerk zurückzugeben, auf die seit einem Monat oder länger nicht mehr zugegriffen wurde, und dann jeden dieser Ordner zu komprimieren.
Der durch das Komprimieren von Ordnern freigegebene Speicherplatz variiert je nach Dateityp, der in diesem Ordner gespeichert ist. Beispielsweise sind .jpg Dateien bereits komprimiert, und die weitere Komprimierung hat nur geringe Auswirkungen auf die Größe der Datei. Bei anderen Dateitypen können die Einsparungen jedoch erheblich sein. Beispielsweise wurde auf einem Windows 2000-basierten Testcomputer ein neuer Ordner erstellt, und 33 Microsoft Word Dokumente, die insgesamt 15 Megabyte (MB) Speicherplatz belegen, wurden in diesen Ordner kopiert. Als die Dokumente komprimiert wurden, belegte der Ordner nur 7 MB Speicherplatz.
Beispiele
Im folgenden VBScript-Beispiel wird der Ordner C:\Scripts komprimiert.
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
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|