Metodo IVdsAdvancedDisk::D eletePartition (vds.h)

Articolo
03/08/2023

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Elimina una partizione da un disco di base.

Sintassi

HRESULT DeletePartition(
  [in] ULONGLONG ullOffset,
  [in] BOOL      bForce,
  [in] BOOL      bForceProtected
);

Parametri

[in] ullOffset

Offset della partizione.

[in] bForce

Se questo parametro è impostato su TRUE, VDS elimina tutte le partizioni in modo incondizionato (escluso OEM, ESP o MSR). Se è impostata su FALSE, l'operazione ha esito negativo se la partizione è in uso. Una partizione viene considerata in uso se le chiamate a bloccare o smontare il volume hanno esito negativo.

[in] bForceProtected

Se questo parametro è impostato su TRUE, VDS elimina tutte le partizioni protette (inclusi OEM, ESP e MSR) in modo incondizionato. Se è impostata su FALSE, l'operazione ha esito negativo se la partizione è protetta.

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	La partizione è stata eliminata correttamente.
VDS_E_INVALID_OPERATION 0x80042415L	Il supporto non supporta questa operazione. Ad esempio, non è possibile eliminare una partizione in un CD-ROM.
VDS_E_NOT_SUPPORTED 0x80042400L	Questa operazione non è supportata nei dischi dinamici.
VDS_E_PARTITION_NOT_EMPTY 0x80042408L	La partizione estesa non è vuota.
VDS_E_BAD_PROVIDER_DATA 0x80042441L	Questo valore indica un errore del provider. L'operazione viene interrotta.
VDS_E_DEVICE_IN_USE 0x80042413L	La partizione è in uso.
VDS_S_ACCESS_PATH_NOT_DELETED 0x00044244L	La partizione è stata eliminata correttamente, ma il disco rigido virtuale non è riuscito a rimuovere i percorsi di accesso.
VDS_S_UPDATE_BOOTFILE_FAILED 0x00042434L	La partizione è stata eliminata correttamente, ma VDS non è riuscito ad aggiornare le opzioni di avvio nell'archivio dei dati di configurazione di avvio (BCD). Windows Server 2003: Le opzioni di avvio vengono archiviate nel file boot.ini in un sistema x86 o x64 o NVRAM in un sistema Itanium.

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

Oggetto Disk

IVdsAdvancedDisk

Condividi tramite