Condividi tramite


Metodo IVdsDisk::QueryExtents (vds.h)

[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 i dettagli di tutti gli extent in un disco.

Sintassi

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

Parametri

[out] ppExtentArray

Variabile puntatore che riceve un oggetto
matrice di strutture VDS_DISK_EXTENT . I chiamanti devono liberare questa matrice usando la funzione CoTaskMemFree .

[out] plNumberOfExtents

Indirizzo di un tipo LONG che rappresenta il numero totale di extent.

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/valore restituito Descrizione
S_OK
Le informazioni sull'estensione sono state restituite correttamente.
VDS_E_PACK_OFFLINE
0x8004244L
Il pacchetto a cui appartiene il disco è inaccessibile.

Commenti

Usare questo metodo per determinare la quantità di spazio disponibile disponibile per la creazione o l'estensione dei volumi. È anche possibile usare le informazioni di estensione per determinare il numero di volumi che occupano il disco. I tipi di estensione validi sono: extent sconosciuti, extent gratuiti, extent di dati, extent OEM, extent ESP, estensioni MSR, estensioni dei metadati LDM e extent inutilizzabili. Un extent di dati contiene un collegamento al volume sopra di esso.

Se il disco è un disco dinamico, deve essere online. Se si tratta di un disco di base o di un disco non elaborato, può essere online o offline.

Requisiti

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

Vedi anche

IVdsDisk

IVdsDisk::ClearFlags

IVdsDisk::ConvertStyle

IVdsDisk::GetIdentificationData

IVdsDisk::GetPack

IVdsDisk::GetProperties

IVdsDisk::SetFlags

VDS_DISK_EXTENT