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

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

Condividi tramite