Método IVdsAdvancedDisk::FormatPartition (vds.h)
[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]
Da formato a una partición existente oem, ESP o desconocida.
Sintaxis
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
);
Parámetros
[in] ullOffset
Desplazamiento de partición.
[in] type
Valor de enumeración VDS_FILE_SYSTEM_TYPE que especifica el sistema de archivos que se va a usar. Debe ser uno de los siguientes: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 o VDS_FST_UDF.
[in] pwszLabel
Cadena que representa la etiqueta de volumen.
[in] dwUnitAllocationSize
Tamaño de la unidad de asignación para el sistema de archivos en bytes, que suele estar entre 512 y 65536.
[in] bForce
Si es TRUE, se da formato a la partición aunque esté en uso; de lo contrario, se produce un error en la operación.
[in] bQuickFormat
Si es TRUE, VDS realiza un formato rápido. Un formato rápido no comprueba cada sector del volumen.
[in] bEnableCompression
Si es TRUE, habilita la compresión en el sistema de archivos recién formateado. La compresión es una característica de NTFS y no se puede establecer para los sistemas de archivos FAT y FAT32.
[out] ppAsync
Dirección de un puntero de interfaz IVdsAsync , que VDS inicializa al devolver. Los autores de llamadas deben liberar la interfaz. Use este puntero para cancelar, esperar o consultar el estado de la operación.
Valor devuelto
Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
La partición se ha formateado correctamente. |
|
El disco es extraíble o la partición no es de tipo OEM, ESP o desconocido. |
|
La partición no existe. |
Comentarios
VDS implementa este método.
Este método solo da formato a las particiones OEM, ESP y desconocidas. Para otras particiones, debe dar formato al volumen correspondiente mediante el método IVdsVolumeMF::Format o IVdsVolumeMF2::FormatEx . Tenga en cuenta que las particiones OEM, ESP y desconocidas no se exponen como volúmenes y, por lo tanto, no se pueden dar formato con Format o FormatEx.
Este método no se puede usar para dar formato a medios extraíbles.
Para obtener información sobre los límites del sistema de archivos, como el tamaño mínimo y máximo de la unidad de asignación (también denominado tamaño de clúster), consulte Referencia técnica ntfs y Referencia técnica fat.
Si una partición OEM tiene el formato FAT o FAT32, el tipo de partición no cambia. Si tiene formato NTFS, el tipo de partición cambia a PARTITION_IFS (0x07). Para obtener información sobre los tipos de partición, consulte CREATE_PARTITION_PARAMETERS.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vds.h |
| Library | Uuid.lib |