Metodo IVdsVolume::AddPlex (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.]

Aggiunge un volume come plex al volume corrente.

Sintassi

HRESULT AddPlex(
  [in]  VDS_OBJECT_ID VolumeId,
  [out] IVdsAsync     **ppAsync
);

Parametri

[in] VolumeId

GUID del volume da aggiungere come plex.

[out] ppAsync

Indirizzo di un puntatore all'interfaccia IVdsAsync , che il VDS inizializza al momento della restituzione. I chiamanti devono rilasciare l'interfaccia. Usare questo puntatore 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	Il plex è stato aggiunto correttamente.
VDS_S_GPT_BOOT_MIRRORED_TO_MBR 0x80042469L	Il volume di avvio su un disco GPT è stato sottoposto a mirroring in un disco MBR. Il nuovo plex non può essere utilizzato per avviare il computer.
VDS_E_VOLUME_NOT_ONLINE 0x8004243DL	Il volume non è accessibile.
VDS_E_VOLUME_NOT_HEALTHY 0x8004243EL	Il volume ha esito negativo o ha avuto esito negativo.
VDS_E_VOLUME_SPANS_DISKS 0x8004243FL	Il volume si estende su più dischi.
VDS_E_REQUIRES_CONTIGUOUS_DISK_SPACE 0x80042440L	Il volume è costituito da più extent.
VDS_E_INVALID_OPERATION 0x80042415L	Il volume di origine è inferiore al volume di destinazione. Se il volume di origine è maggiore del volume di destinazione, il volume di destinazione rimane invariato e l'operazione ha esito positivo.

Commenti

Questa operazione non è valida per i volumi di base, che hanno esattamente un plex.

Utilizzare questo metodo per aggiungere un volume come plex a un altro volume. Ad esempio, un chiamante può creare un volume (volume B), specificare il volume B come nuovo plex in un volume esistente (volume A), quindi rimuovere il volume B. Il nuovo plex del volume A occupa gli stessi extent del disco del volume B.

Nota VDS tenta di usare gli stessi extent, ma non può garantire questo comportamento.

I chiamanti possono aggiungere un volume con mirroring come nuovo plex a un altro volume. Il volume risultante contiene iplexes uguali in numero alla somma dei volumi originali.

Gli implementatori devono restituire un puntatore all'interfaccia IVdsAsync per questo metodo, indipendentemente dal fatto che la chiamata avvii 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

Vedi anche

IVdsAsync

IVdsVolume

Oggetto Volume Plex

Condividi tramite