IVdsVolumeShrink::QueryMaxReclaimableBytes-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]
Ruft die maximale Anzahl von Bytes ab, die vom aktuellen Volume abgerufen werden können.
Syntax
HRESULT QueryMaxReclaimableBytes(
[out] ULONGLONG *pullMaxNumberOfReclaimableBytes
);
Parameter
[out] pullMaxNumberOfReclaimableBytes
Zeiger auf eine Variable, die nach erfolgreicher Fertigstellung die maximale Anzahl von Bytes empfängt, die vom aktuellen Volume abgerufen werden können. Diese Zahl ist immer ein Vielfaches der Größe des Dateisystemclusters, was wiederum ein Vielfaches der Größe des Datenträgersektors ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
Rückgabewert
Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des makros HRESULT_FROM_WIN32 zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Das Volume kann nicht verkleinert werden, da es vom Dateisystem nicht unterstützt wird. |
|
Der Vorgang wird auf Wechselmedien nicht unterstützt. |
|
Der pullMaxNumberOfReclaimableBytes-Parameter war bei der Eingabe NULL. |
Hinweise
Diese Methode kann mehr freizugebende Bytes zurückgeben, als tatsächlich verfügbar sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vds.h |
| Bibliothek | Uuid.lib |