Metodo IVdsOpenVDisk::Expand (vds.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.

Aumenta le dimensioni di un disco virtuale alle dimensioni massime disponibili in un disco fisso o espandibile.

Sintassi

HRESULT Expand(
  [in]  EXPAND_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONGLONG                NewSize,
  [out] IVdsAsync                **ppAsync
);

Parametri

[in] Flags

Valore di enumerazione EXPAND_VIRTUAL_DISK_FLAG che specifica la modalità di espansione del disco virtuale. Deve essere impostato su EXPAND_VIRTUAL_DISK_FLAG_NONE.

[in] NewSize

Dimensioni desiderate in byte del disco virtuale espanso.

[out] ppAsync

Puntatore a un'interfaccia IVdsAsync che al termine del completamento riceve l'interfaccia IVdsAsync per monitorare e controllare questa operazione. I chiamanti devono rilasciare l'interfaccia ricevuta al termine dell'operazione. Se il metodo IVdsAsync::Wait viene chiamato sull'interfaccia e viene restituito un valore HRESULT riuscito, le interfacce restituite nella struttura VDS_ASYNC_OUTPUT devono essere rilasciate chiamando il metodo IUnknown::Release in ogni puntatore dell'interfaccia. Tuttavia, se Wait restituisce un valore HRESULT non riuscito o se il parametro pHrResultdiWait riceve un valore HRESULT non riuscito, i puntatori di interfaccia nella struttura VDS_ASYNC_OUTPUT sono NULL e non devono essere rilasciati. È possibile testare i valori HRESULT di esito positivo o negativo usando le macro SUCCESSED e FAILED definite in Winerror.h.

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

Un disco virtuale può essere espanso solo se è scollegato.

Il disco virtuale deve essere stato aperto con accesso per eseguire operazioni di metadati. Corrisponde al valore VIRTUAL_DISK_ACCESS_METAOPS dell'enumerazione VIRTUAL_DISK_ACCESS_MASK .

Requisiti

   
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

IVdsOpenVDisk