IVdsHwProviderStoragePools::QueryStoragePools-Methode (vds.h)

  • Artikel

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

Gibt ein IEnumVdsObject-Enumerationsobjekt zurück, das eine Liste der vom Hardwareanbieter verwalteten Speicherpools enthält.

Syntax

HRESULT QueryStoragePools(
  [in]  ULONG               ulFlags,
  [in]  ULONGLONG           ullRemainingFreeSpace,
  [in]  VDS_POOL_ATTRIBUTES *pPoolAttributes,
  [out] IEnumVdsObject      **ppEnum
);

Parameter

[in] ulFlags

Eine Bitmaske eines oder mehrerer VDS_STORAGE_POOL_TYPE Flags, die die Typen der abzufragenden Speicherpools angeben. Eines der Flags muss entweder VDS_SPT_CONCRETE oder VDS_SPT_PRIMORDIAL sein. Der Standardwert dieses Parameters ist 0 (Null). Der Wert 0 (null) bedeutet, dass alle Speicherpools abgefragt werden sollten.

[in] ullRemainingFreeSpace

Die Mindestmenge an freiem Speicherplatz in Bytes, die jeder Speicherpool enthalten muss. Der Standardwert für diesen Parameter ist Null. Der Wert 0 bedeutet, dass die Speicherpools eine beliebige Menge an freiem Speicherplatz enthalten können.

[in] pPoolAttributes

Ein Zeiger auf eine VDS_POOL_ATTRIBUTES-Struktur , die die Attributwerte angibt, die die zurückgegebenen Speicherpools aufweisen müssen. Der Standardwert für diesen Parameter ist NULL. Der Wert NULL bedeutet, dass die Speicherpools beliebige Attributwerte aufweisen können.

[out] ppEnum

Die Adresse eines IEnumVdsObject-Schnittstellenzeigers , der zum Aufzählen der Speicherpools verwendet werden kann. Weitere Informationen finden Sie unter Arbeiten mit Enumerationsobjekten. Aufrufer müssen die Schnittstelle und die einzelnen Speicherpoolobjekte freigeben, wenn sie nicht mehr benötigt werden, indem sie die IUnknown::Release-Methode aufrufen. 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 BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.

Bemerkungen

Wenn der Hardwareanbieter keine Speicherpools verwaltet, gibt diese Methode ein leeres Enumerationsobjekt zurück.

Wenn im pPoolAttributes-Parameter ein Wert ungleich NULL angegeben wird, gibt diese Methode nur Speicherpools zurück, die alle Attribute erfüllen, die in der VDS_POOL_ATTRIBUTES-Struktur angegeben sind. Wenn minimale und maximale Attribute angegeben werden, müssen die zurückgegebenen Speicherpools genau mit diesen Attributen übereinstimmen. Die Hinweisattribute werden als Hinweise verwendet, um die Speicherpools weiter zu filtern, die alle angegebenen Attribute erfüllen. Wenn ein angegebenes Attribut für keinen der Speicherpools gilt, gibt diese Methode S_OK mit einem leeren Enumerationsobjekt zurück.

Anforderungen

Anforderung Wert
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

Weitere Informationen

IVdsHwProviderStoragePools