Metodo IVdsHwProviderStoragePools::QueryStoragePools (vdshwprv.h)

  • Articolo

[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 su cui eseguire query. Uno dei flag deve essere VDS_SPT_CONCRETE o VDS_SPT_PRIMORDIAL. Il valore predefinito di questo parametro è zero. Il valore zero indica che è necessario eseguire query su tutti i pool di archiviazione.

[in] ullRemainingFreeSpace

Quantità minima di spazio disponibile, in byte, che ogni pool di archiviazione deve contenere. Il valore predefinito per questo parametro è zero. Il valore 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 di attributo che devono essere presenti nei pool di archiviazione restituiti. Il valore predefinito per questo parametro è NULL. Un valore NULL indica che i pool di archiviazione possono avere qualsiasi valore di attributo.

[out] ppEnum

Indirizzo di un puntatore all'interfaccia IEnumVdsObject che può essere usato per enumerare i pool di archiviazione. Per altre informazioni, vedere Utilizzo 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 provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice restituito Descrizione
S_OK
 Metodo completato correttamente.

Commenti

Se il provider hardware non gestisce alcun 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 minimo e massimo, 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 ad alcun pool di archiviazione, questo metodo restituisce S_OK con un oggetto enumerazione vuoto.

Requisiti

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

Vedi anche

IVdsHwProviderStoragePools