Método CreatePartition de la clase MSFT_Disk
Crea una partición en un disco.
Sintaxis
UInt32 CreatePartition(
[in] UInt64 Size,
[in] Boolean UseMaximumSize,
[in] UInt64 Offset,
[in] UInt32 Alignment,
[in] Char16 DriveLetter,
[in] Boolean AssignDriveLetter,
[in] UInt16 MbrType,
[in] String GptType,
[in] Boolean IsHidden,
[in] Boolean IsActive,
[out] String CreatedPartition,
[out] String ExtendedStatus
);
Parámetros
Tamaño [in]
Tamaño deseado, en bytes, para la partición. Debe ser igual o menor que el tamaño especificado por la propiedad LargestFreeExtent del disco. Este parámetro no se puede usar con UseMaximumSize.
UseMaximumSize [in]
Si es TRUE, la partición rellenará la mayor extensión libre en el disco. Este parámetro no se puede usar con el parámetro Size .
Desplazamiento [in]
Desplazamiento de partición, en bytes. Si el desplazamiento no está alineado y no se especifica el parámetro Alignment , el desplazamiento se redondea hacia arriba o hacia abajo hasta el límite de alineación más cercano, dependiendo del tamaño del disco en el que se crea la partición.
Alineación [in]
Alineación de la partición, en bytes.
DriveLetter [in]
Letra de unidad que se va a asignar a la partición en el momento de la creación. Este parámetro no se puede usar con AssignDriveLetter. Si se especifican ambos parámetros, se devolverá un error parámetro no válido. Si la letra de unidad no está disponible, se creará la partición, pero se devolverá el error "42002".
AssignDriveLetter [in]
Si es TRUE, la siguiente letra de unidad disponible se asignará a la partición creada. Si no hay más letras de unidad disponibles, la partición se creará sin letra de unidad. Este parámetro no se puede usar con DriveLetter. Si se especifican ambos parámetros, se devolverá un error parámetro no válido.
MbrType [in]
Especifica el tipo de partición MBR. Este parámetro solo se puede establecer si la propiedad PartitionStyle del disco es MBR; de lo contrario, se devolverá un error. El valor predeterminado de este parámetro es Huge.
| Valor | Significado |
|---|---|
| FAT12 1 | Partición del sistema de archivos FAT12. |
| FAT16 4 | Partición del sistema de archivos FAT16. |
| Extendido 5 | Partición extendida. |
| Enorme 6 | Una partición enorme. Este valor indica que no hay ningún sistema de archivos de Windows en la partición. Use este valor al crear un volumen lógico. |
| IFS 7 | Una partición NTFS o ExFAT. |
| FAT32 12 | Partición FAT32. |
GptType [in]
Tipo GPT de la partición. Este parámetro solo es válido si la propiedad PartitionStyle del disco es GPT; de lo contrario, se devolverá un error. El valor predeterminado de este parámetro es Datos básicos.
| Valor | Significado |
|---|---|
| Partición del sistema c12a7328-f81f-11d2-ba4b-00a0c93ec93b | Una partición del sistema EFI. |
| Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae | Partición reservada de Microsoft. |
| Datos básicos ebd0a0a2-b9e5-4433-87c0-68b6b72699c7 | Una partición de datos básica. Este es el tipo de partición de datos que Windows crea y reconoce. Solo se pueden asignar particiones de este tipo a letras de unidad, recibir rutas guid de volumen, hospedar carpetas montadas (también denominadas puntos de montaje de volumen) y enumerarse mediante llamadas a FindFirstVolume y FindNextVolume. |
| Metadatos ldm 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3 | Partición de metadatos del Administrador de discos lógicos (LDM) en un disco dinámico. |
| LDM Data af9b60a0-1431-4f62-bc68-3311714a69ad | La partición es una partición de datos LDM en un disco dinámico. |
| Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac | Una partición de recuperación de Microsoft. |
IsHidden [in]
Si es TRUE, la partición no podrá recibir una asignación de letra de unidad ni el administrador de montaje asignará un nombre GUID de volumen. La partición no se enumerará mediante las funciones FindFirstVolume y FindNextVolume . La partición se puede abrir por su nombre de dispositivo de volumen asociado (por ejemplo, "\\? GLOBALROOT\Device\HarddiskVolumeX").
IsActive [in]
Si es TRUE, se establecerá el bit activo MBR de la partición y la partición se iniciará. Este parámetro solo es válido para discos MBR.
CreatedPartition [out]
Cadena que contiene un objeto MSFT_Partition incrustado que representa la partición que se creó.
ExtendedStatus [out]
Cadena que contiene un objeto MSFT_StorageExtendedStatus incrustado.
Este parámetro permite al proveedor de almacenamiento devolver información de error extendida (específica de la implementación).
Valor devuelto
Correcto (0)
No compatible (1)
Error no especificado (2)
Tiempo de espera (3)
Error (4)
Parámetro no válido (5)
El disco está en uso (6)
Tamaño no admitido (4097)
Espacio libre insuficiente (40000)
Acceso denegado (40001)
No hay suficientes recursos para completar la operación. (40002)
Caché obsoleta (40003)
Debe especificar un tamaño mediante el parámetro Size o UseMaximumSize. Solo puede especificar uno de estos parámetros a la vez. (40005)
El disco no se ha inicializado. (41000)
El disco es de solo lectura. (41002)
El disco está sin conexión. (41003)
Se ha alcanzado el límite de particiones del disco. (41004)
La alineación de partición especificada no es válida. Debe ser un múltiplo del tamaño del sector del disco. (41005)
Un parámetro no es válido para este tipo de partición. (41006)
El tipo de partición especificado no es válido. (41010)
Solo se pueden usar los primeros 2 TB en discos MBR. (41011)
El desplazamiento especificado no es válido. (41012)
No hay ningún medio en el dispositivo. (41015)
El desplazamiento especificado no es válido. (41016)
El diseño de partición especificado no es válido. (41017)
El componente Clústeres de conmutación por error de Microsoft administra el objeto especificado. El disco debe estar en modo de mantenimiento del clúster y el estado del recurso del clúster debe estar en línea para realizar esta operación. (41018)
La ruta de acceso solicitada ya está en uso. (42002)
No se pueden asignar rutas de acceso a particiones ocultas. (42004)
La ruta de acceso no es válida. (42007)
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Espacio de nombres | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |