Metodo IVdsVolume::RemovePlex (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.
Rimuove uno o più plessi specificati dal volume corrente, rilasciando gli extent.
Sintassi
HRESULT RemovePlex(
[in] VDS_OBJECT_ID plexId,
[out] IVdsAsync **ppAsync
);
Parametri
[in] plexId
GUID del plex da rimuovere.
[out] ppAsync
Indirizzo di un puntatore dell'interfaccia IVdsAsync , che il VDS inizializza sul ritorno. I chiamanti devono rilasciare l'interfaccia. Usare questo puntatore per annullare, attendere o eseguire 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 derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.
| Codice/valore restituito | Descrizione |
|---|---|
|
Il plex è stato rimosso correttamente. |
|
Il volume non è accessibile. |
|
Il volume non è un mirroring. |
Commenti
Questa operazione non può rimuovere l'ultimo plex di un volume. Usare invece il metodo IVdsVolume::D elete per rimuovere l'ultimo volume rimanente (il solo plex). Questo metodo non è valido per i volumi di base, che hanno esattamente un plex.
Il VDS non smonta il volume quando rimuove un plex.
Gli implementatori devono restituire un puntatore all'interfaccia IVdsAsync per questo metodo, indipendentemente dal fatto che la chiamata avvia un'operazione asincrona.
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 |