Metodo IVdsAdvancedDisk::FormatPartition (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.

Formatta una partizione OEM, ESP o sconosciuta esistente.

Sintassi

HRESULT FormatPartition(
  [in]  ULONGLONG            ullOffset,
  [in]  VDS_FILE_SYSTEM_TYPE type,
  [in]  LPWSTR               pwszLabel,
  [in]  DWORD                dwUnitAllocationSize,
  [in]  BOOL                 bForce,
  [in]  BOOL                 bQuickFormat,
  [in]  BOOL                 bEnableCompression,
  [out] IVdsAsync            **ppAsync
);

Parametri

[in] ullOffset

Offset di partizione.

[in] type

Valore di enumerazione VDS_FILE_SYSTEM_TYPE che specifica il file system da usare. Deve essere uno dei seguenti: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 o VDS_FST_UDF.

[in] pwszLabel

Stringa che rappresenta l'etichetta del volume.

[in] dwUnitAllocationSize

Dimensioni dell'unità di allocazione per il file system in byte, che in genere è compresa tra 512 e 65536.

[in] bForce

Se TRUE, la partizione viene formattata anche durante l'uso; in caso contrario, l'operazione ha esito negativo.

[in] bQuickFormat

Se TRUE, VDS esegue un formato rapido. Un formato rapido non verifica ogni settore nel volume.

[in] bEnableCompression

Se TRUE, abilita la compressione nel file system appena formattato. La compressione è una funzionalità DI NTFS e non può essere impostata per i file system FAT e FAT32.

[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
S_OK	La partizione è stata formattata correttamente.
VDS_E_INVALID_OPERATION 0x80042415L	Il disco è rimovibile o la partizione non è di tipo OEM, ESP o sconosciuto.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	La partizione non esiste.

Commenti

VDS implementa questo metodo.

Questo metodo formatta solo partizioni OEM, ESP e sconosciute. Per altre partizioni, è invece necessario formattare il volume corrispondente usando il metodo IVdsVolumeMF::Format o IVdsVolumeMF2::FormatEx . Si noti che le partizioni OEM, ESP e sconosciute non vengono esposte come volumi e pertanto non possono essere formattate con Format o FormatEx.

Questo metodo non può essere usato per formattare supporti rimovibili.

Per informazioni sui limiti del file system, ad esempio dimensioni minime e massime dell'unità di allocazione (denominate anche dimensioni del cluster), vedere Informazioni di riferimento tecnico NTFS e FAT Technical Reference.

Se una partizione OEM viene formattata come FAT o FAT32, il tipo di partizione non cambia. Se è formattato con NTFS, il tipo di partizione viene modificato in PARTITION_IFS (0x07). Per informazioni sui tipi di partizione, vedere CREATE_PARTITION_PARAMETERS.

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

IVdsAsync

IVdsDiskPartitionMF::FormatPartitionEx

VDS_FILE_SYSTEM_TYPE

Condividi tramite