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

Unione di un disco virtuale figlio con i relativi genitori nella catena di differenze.

Sintassi

HRESULT Merge(
  [in]  MERGE_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                   MergeDepth,
  [out] IVdsAsync               **ppAsync
);

Parametri

[in] Flags

Valore di enumerazione MERGE_VIRTUAL_DISK_FLAG che specifica la modalità di unione del disco virtuale. Deve essere impostato su MERGE_VIRTUAL_DISK_FLAG_NONE.

[in] MergeDepth

Numero di dischi padre nella catena di differenze da unire. Il disco deve essere stato aperto con un valore ReadWriteDepth almeno uguale a questo valore.

[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 unito solo se è scollegato.

Questo metodo sposta tutti i blocchi di dati dal disco figlio all'elemento padre. Tuttavia, non eliminerà i dischi figlio invalidati alla fine dell'operazione.

Il disco virtuale deve essere stato aperto con accesso in lettura/scrittura.

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

IVdsOpenVDisk

Condividi tramite