IVdsStoragePool::QueryDriveExtents-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]
Gibt ein Array der Laufwerksblöcke zurück, die von einem Speicherpool verwendet werden.
Syntax
HRESULT QueryDriveExtents(
[out] VDS_STORAGE_POOL_DRIVE_EXTENT **ppExtentArray,
[out] LONG *plNumberOfExtents
);
Parameter
[out] ppExtentArray
Ein Zeiger auf das Array von VDS_STORAGE_POOL_DRIVE_EXTENT Strukturen, die vom Aufrufer übergeben werden. Diese Strukturen beschreiben die vom Speicherpool verwendeten Laufwerksblöcke. Aufrufer müssen dieses Array mithilfe der Funktion CoTaskMemFree freigeben.
[out] plNumberOfExtents
Ein Zeiger auf die Anzahl der im ppExtentArray-Array zurückgegebenen Blöcke.
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 | Beschreibung |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vds.h |
| Bibliothek | Uuid.lib |