Método IVdsAdvancedDisk::FormatPartition (vds.h)

Artículo
03/08/2023

[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
S_OK	La partición se ha formateado correctamente.
VDS_E_INVALID_OPERATION 0x80042415L	El disco es extraíble o la partición no es de tipo OEM, ESP o desconocido.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	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