Condividi tramite


Metodo IVdsPack::AddDisk (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.

Aggiunge un disco a un pacchetto online.

Sintassi

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

Parametri

[in] DiskId

GUID del disco.

[in] PartitionStyle

Lo stile può essere MBR o GPT. Vedere l'enumerazione VDS_PARTITION_STYLE .

[in] bAsHotSpare

Se true, VDS può usare il disco come un hot spare; in caso contrario, il disco non può essere usato per questa operazione. Solo i provider hardware supportano la spaziatura frequente.

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
S_OK
Il disco è stato aggiunto correttamente.
VDS_E_NOT_AN_UNALLOCATED_DISK
0x80042418L
Il disco non è elaborato.
VDS_E_OPERATION_DENIED
0x8004240AL
Il disco da aggiungere viene pulito.
VDS_E_PROVIDER_FAILURE
0x80042442L
Si verifica un errore del provider durante l'operazione.
VDS_E_NOT_SUPPORTED
0x80042400L
L'aggiunta di un secondo disco a un pacchetto di base non è supportata.
VDS_E_PACK_OFFLINE
0x8004244L
Il pacchetto di destinazione non è accessibile.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
Il disco non viene trovato.
VDS_E_DMADMIN_METHOD_CALL_FAILED
0x80042420L
Il servizio gestione dischi logici (LDM) non è riuscito a completare un metodo.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
La cache del provider dinamico è danneggiata.

Commenti

VDS implementa questo metodo.

Questo metodo inizializza un disco non elaborato (un disco senza partizionamento definito) e lo aggiunge al pacchetto. Prima di chiamare questo metodo, il disco non elaborato è di proprietà del servizio VDS. Dopo che questo metodo restituisce, il disco è di proprietà del provider di base.

Per annullare l'effetto di questo metodo, ovvero rimuovere il formato di partizionamento e causare che il disco sia un disco non elaborato di proprietà del servizio VDS, usare il metodo IVdsAdvancedDisk::Clean .

Non è possibile usare AddDisk per ridefinire il partizionamento in un disco esistente.

Se si aggiunge un disco GPT a un pacchetto di base, l'operazione crea automaticamente una partizione MSR sul disco. I dispositivi che eseguono il sistema operativo WinPE sono l'eccezione perché un amministratore potrebbe preferire creare una partizione ESP sul disco. La partizione ESP, se presente, deve essere la prima partizione sul disco.

Se si aggiunge il disco a un pacchetto dinamico, l'operazione non crea una partizione MSR.

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

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE