Resize-Methode der MSFT_Partition-Klasse
Ändert die Größe der Partition und jedes zugeordnete Dateisystemvolume auf die größe, die durch den Size-Parameter angegeben wird.
Syntax
UInt32 Resize(
[in] UInt64 Size,
[out] String ExtendedStatus
);
Parameter
Größe [in]
Die neue Größe für den Datenträger. Dieser Parameter ist erforderlich und darf nicht 0 (null) sein.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Dieser Parameter ermöglicht es dem Speicheranbieter, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.
Rückgabewert
Erfolg (0)
Nicht unterstützt (1)
Nicht angegebener Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Größe nicht unterstützt (4097)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Eine Partition, die ein Volume mit Fehlern enthält, kann nicht verkleinern. (42008)
Die Größe einer Partition, die ein unbekanntes Dateisystem enthält, kann nicht geändert werden. (42009)
Hinweise
Diese Methode ändert die Größe der Partition und jedes zugeordnete Dateisystem auf die größe, die durch den Size-Parameter angegeben wird. Wenn die Größe außerhalb der von der GetSupportedSize-Methode zurückgegebenen Grenzen liegt, schlägt diese Methode mit einem klar definierten Fehlercode fehl. Der Größenänderungsvorgang wird nur für NTFS-formatierte Partitionen und RAW-Partitionen unterstützt.
Wenn die angegebene Größe kleiner als die ursprüngliche Größe ist, werden Dateien mit dieser Methode so verschoben, dass sie so nahe wie möglich am Anfang der Partition liegen, um freien Speicherplatz am Ende der Partition zu konsolidieren. Anschließend wird das Dateisystemvolume abgeschnitten, dessen Größe verringert, und die Partition wird dann abgeschnitten.
In fast allen Fällen wird es einige Dateien geben, die unbeweglich sind (d.a. können nicht verschoben werden). Beispielsweise sind Dateisystem- und Speichertreibermetadatendateien wahrscheinlich unveränderlich. Aus diesem Grund ist der Betrag, um den eine Partition verkleinert werden kann, in der Regel kleiner als die Gesamtmenge des freien Speicherplatzes auf der Partition.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |