Metodo IVdsVolumeMF::Format (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 un file system nel volume corrente.

Sintassi

HRESULT Format(
  [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] type

Valore di enumerazione VDS_FILE_SYSTEM_TYPE che specifica il file system da utilizzare. 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 file system.

[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, il file system viene formattato in modo condizionale anche mentre è in uso; in caso contrario, l'operazione ha esito negativo.

[in] bQuickFormat

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

[in] bEnableCompression

Se TRUE, la compressione è abilitata nel file system appena formattato. La compressione è una funzionalità di NTFS e viene ignorata per FAT e FAT32.

[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 file system è stato formattato correttamente.
VDS_E_OPERATION_DENIED 0x8004240AL	L'operazione viene negata se il chiamante tenta di formattare il sistema, l'avvio, l'arresto anomalo, l'ibernazione o i volumi di file di paging.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Il volume non è riuscito.
VDS_E_PACK_OFFLINE 0x8004244L	Il pacchetto contenente il volume non è accessibile. Tutti i volumi in un pacchetto offline non sono accessibili.

Inoltre, l'interfaccia IVdsAsync può restituire i codici di errore e gli avvisi correlati seguenti.

Codice/valore restituito	Descrizione
VDS_S_VOLUME_COMPRESS_FAILED 0x00042443L	Il file system è formattato ma non compresso.
VDS_E_INCOMPATIBLE_FILE_SYSTEM 0x80042425L	Il file system non è compatibile.
VDS_E_INCOMPATIBLE_MEDIA 0x80042426L	Il supporto non è compatibile.
VDS_E_ACCESS_DENIED 0x80042427L	Accesso negato.
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	Il supporto è protetto da scrittura.
VDS_E_BAD_LABEL 0x80042429L	L'etichetta non è valida.
VDS_E_CANT_QUICK_FORMAT 0x8004242AL	Impossibile formattare rapidamente il volume.
VDS_E_IO_ERROR 0x8004242BL	Si è verificato un errore di I/O durante il formato.
VDS_E_VOLUME_TOO_SMALL 0x8004242CL	La dimensione del volume è troppo piccola per formattare.
VDS_E_VOLUME_TOO_BIG 0x8004242DL	La dimensione del volume è troppo grande per formattare.
VDS_E_CLUSTER_SIZE_TOO_SMALL 0x8004242EL	Le dimensioni del cluster sono troppo piccole per consentire la formattazione.
VDS_E_CLUSTER_SIZE_TOO_BIG 0x8004242FL	Le dimensioni del cluster sono troppo grandi per consentire la formattazione.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS 0x80042430L	Il numero di cluster è troppo grande per rappresentare come intero a 32 bit.
VDS_E_INVALID_FS_TYPE 0x80042561L	Il valore del parametro di tipo non è stato VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 o VDS_FST_UDF.
VDS_E_CANT_INVALIDATE_FVE 0x80042592L	Non è stato possibile disabilitare la crittografia BitLocker per il volume.

Commenti

Per creare un volume di avvio su un disco dinamico, è necessario chiamare IVdsVolume::SetFlags per impostare il flag VDS_VF_INSTALLABLE prima di chiamare Format per formattare il volume.

Se una partizione OEM è 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.

Se questo metodo viene chiamato per un volume protetto dalla crittografia con volume completo BitLocker, la crittografia BitLocker viene disabilitata per il volume fino a quando l'utente non lo abilita nuovamente.

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

Requisiti


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

IVdsVolumeMF

VDS_FILE_SYSTEM_TYPE

Condividi tramite