IVdsDisk::QueryExtents-Methode (vds.h)

Artikel
03/06/2024

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Gibt die Details aller Ausdehnungen auf einem Datenträger zurück.

Syntax

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

Parameter

[out] ppExtentArray

Eine Zeigervariable, die eine
Array von VDS_DISK_EXTENT Strukturen. Aufrufer müssen dieses Array mithilfe der Funktion CoTaskMemFree freigeben.

[out] plNumberOfExtents

Die Adresse eines Typs LONG , die die Gesamtzahl der Ausdehnungen darstellt.

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 HRESULT_FROM_WIN32-Makros 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
S_OK	Die Erweiterungsinformationen wurden erfolgreich zurückgegeben.
VDS_E_PACK_OFFLINE 0x80042444L	Auf das Pack, zu dem der Datenträger gehört, kann nicht zugegriffen werden.

Hinweise

Verwenden Sie diese Methode, um die Menge des verfügbaren freien Speicherplatzes zum Erstellen oder Erweitern von Volumes zu bestimmen. Sie können auch die Umfangsinformationen verwenden, um zu bestimmen, wie viele Volumes den Datenträger belegen. Gültige Erweiterungstypen sind: unbekannte Erweiterungen, freie Erweiterungen, Datenausdehnungen, OEM-Erweiterungen, ESP-Erweiterungen, MSR-Erweiterungen, LDM-Metadatenausdehnungen und nicht verwendbare Erweiterungen. Ein Datenbereich enthält einen Link zum Volume darüber.

Wenn es sich bei dem Datenträger um einen dynamischen Datenträger handelt, muss er online sein. Wenn es sich um einen einfachen Datenträger oder einen Rohdatenträger handelt, kann er online oder offline sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vds.h
Bibliothek	Uuid.lib