Metodo IVdsPack::ReplaceDisk (vds.h)

Articolo
03/03/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.]

Non supportato.

Questo metodo è riservato per utilizzi futuri.

Sintassi

HRESULT ReplaceDisk(
  [in]  VDS_OBJECT_ID OldDiskId,
  [in]  VDS_OBJECT_ID NewDiskId,
  [out] IVdsAsync     **ppAsync
);

Parametri

[in] OldDiskId

GUID del disco precedente.

[in] NewDiskId

GUID del nuovo disco.

[out] ppAsync

Indirizzo di un puntatore all'interfaccia IVdsAsync , che il VDS inizializza al momento della restituzione. I chiamanti devono rilasciare l'interfaccia. Usare questa interfaccia per annullare, attendere o eseguire una query sullo stato dell'operazione.

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/valore restituito	Descrizione
S_OK	Sostituzione del disco completata correttamente.
VDS_E_NOT_SUPPORTED 0x80042400L	Questo metodo non è supportato in questa versione.

Commenti

I chiamanti possono usare questo metodo per la migrazione dei supporti (sostituendo un disco precedente con un nuovo disco) o durante il ripristino di un set a tolleranza di errore con un membro mancante o non riuscito, in particolare per i provider che non implementano la spaziatura ad accesso frequente.

Il nuovo disco deve trovarsi nello stesso pacchetto del disco precedente e non può contenere dati; può avere lo stile di partizionamento errato. In caso di sostituzione riuscita, il disco precedente mantiene lo stile di partizionamento ma non i volumi validi.

Gli implementatori devono restituire un puntatore all'interfaccia IVdsAsync per questo metodo, indipendentemente dal fatto che la chiamata avvii un'operazione asincrona. Se il provider non implementa l'attivazione a caldo, deve supportare lo scenario membro non riuscito: avviare di nuovo la sincronizzazione del volume esposto a tolleranza di errore dopo che il chiamante richiama il metodo ReplaceDisk .

Requisiti

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

Condividi tramite