Metodo IVdsHwProviderStoragePools::QueryStoragePools (vds.h)

Articolo
03/13/2024

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.

Restituisce un oggetto di enumerazione IEnumVdsObject contenente un elenco dei pool di archiviazione gestiti dal provider hardware.

Sintassi

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

Parametri

[in] ulFlags

Maschera di bit di uno o più flag VDS_STORAGE_POOL_TYPE che specificano i tipi di pool di archiviazione da eseguire query. Uno dei flag deve essere VDS_SPT_CONCRETE o VDS_SPT_PRIMORDIAL. Il valore predefinito di questo parametro è zero. Un valore pari a zero indica che tutti i pool di archiviazione devono essere sottoposti a query.

[in] ullRemainingFreeSpace

Quantità minima di spazio libero, in byte, che ogni pool di archiviazione deve contenere. Il valore predefinito per questo parametro è zero. Un valore pari a zero indica che i pool di archiviazione possono contenere qualsiasi quantità di spazio libero.

[in] pPoolAttributes

Puntatore a una struttura VDS_POOL_ATTRIBUTES che specifica i valori dell'attributo che i pool di archiviazione restituiti devono avere. Il valore predefinito per questo parametro è NULL. Un valore NULL indica che i pool di archiviazione possono avere valori di attributo.

[out] ppEnum

Indirizzo di un puntatore dell'interfaccia IEnumVdsObject che può essere usato per enumerare i pool di archiviazione. Per altre informazioni, vedere Uso degli oggetti di enumerazione. I chiamanti devono rilasciare l'interfaccia e ognuno degli oggetti del pool di archiviazione quando non sono più necessari chiamando il metodo IUnknown::Release . Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.

Commenti

Se il provider hardware non gestisce i pool di archiviazione, questo metodo restituisce un oggetto di enumerazione vuoto.

Se nel parametro pPoolAttributes viene specificato un valore non NULL, questo metodo restituisce solo pool di archiviazione che soddisfano tutti gli attributi specificati nella struttura VDS_POOL_ATTRIBUTES. Se vengono specificati attributi minimi e massimi, i pool di archiviazione restituiti devono corrispondere esattamente a questi attributi. Gli attributi hint vengono usati come hint per filtrare ulteriormente i pool di archiviazione che soddisfano tutti gli attributi specificati. Se un attributo specificato non si applica a nessuno dei pool di archiviazione, questo metodo restituisce S_OK con un oggetto di enumerazione vuoto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Libreria	Uuid.lib

Vedi anche

IVdsHwProviderStoragePools

Condividi tramite