Metodo CreatePartition della classe MSFT_Disk
Crea una partizione su un disco.
Sintassi
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
);
Parametri
Dimensioni [in]
Dimensione desiderata, in byte, per la partizione. Deve essere uguale o minore della dimensione specificata dalla proprietà LargestFreeExtent del disco. Questo parametro non può essere usato con UseMaximumSize.
UseMaximumSize [in]
Se TRUE, la partizione riempirà l'extent libero più grande sul disco. Questo parametro non può essere usato con il parametro Size .
Offset [in]
Offset della partizione, in byte. Se l'offset non è allineato e il parametro Alignment non viene specificato, l'offset viene arrotondato verso l'alto o verso il basso fino al limite di allineamento più vicino, a seconda delle dimensioni del disco in cui viene creata la partizione.
Allineamento [in]
Allineamento della partizione, in byte.
DriveLetter [in]
Lettera di unità da assegnare alla partizione al momento della creazione. Questo parametro non può essere usato con AssignDriveLetter. Se vengono specificati entrambi i parametri, verrà restituito un errore Parametro non valido. Se la lettera di unità non è disponibile, verrà creata la partizione, ma verrà restituito l'errore '42002'.
AssignDriveLetter [in]
Se TRUE, la successiva lettera di unità disponibile verrà assegnata alla partizione creata. Se non sono disponibili altre lettere di unità, la partizione verrà creata senza lettera di unità. Questo parametro non può essere usato con DriveLetter. Se vengono specificati entrambi i parametri, verrà restituito un errore Parametro non valido.
MbrType [in]
Specifica il tipo di partizione MBR. Questo parametro può essere impostato solo se la proprietà PartitionStyle del disco è MBR. In caso contrario, verrà restituito un errore. Il valore predefinito di questo parametro è Huge.
| Valore | Significato |
|---|---|
| FAT12 1 | Partizione del file system FAT12. |
| FAT16 4 | Partizione del file system FAT16. |
| Esteso 5 | Partizione estesa. |
| Enorme 6 | Una partizione enorme. Questo valore indica che nella partizione non è presente alcun file system di Windows. Usare questo valore durante la creazione di un volume logico. |
| IFS 7 | Partizione NTFS o ExFAT. |
| FAT32 12 | Partizione FAT32. |
GptType [in]
Tipo GPT della partizione. Questo parametro è valido solo se la proprietà PartitionStyle del disco è GPT, in caso contrario verrà restituito un errore. Il valore predefinito per questo parametro è Dati di base.
| Valore | Significato |
|---|---|
| Partizione di sistema c12a7328-f81f-11d2-ba4b-00a0c93ec93b | Partizione di sistema EFI. |
| Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae | Partizione riservata Microsoft. |
| Dati di base ebd0a0a2-b9e5-4433-87c0-68b6b72699c7 | Partizione di dati di base. Si tratta del tipo di partizione di dati creato e riconosciuto da Windows. Solo le partizioni di questo tipo possono essere assegnate lettere di unità, ricevere percorsi GUID del volume, cartelle montate host (dette anche punti di montaggio del volume) ed essere enumerate dalle chiamate a FindFirstVolume e FindNextVolume. |
| Metadati LDM 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3 | Partizione di metadati LDM (Logical Disk Manager) in un disco dinamico. |
| Dati LDM af9b60a0-1431-4f62-bc68-33111714a69ad | La partizione è una partizione di dati LDM in un disco dinamico. |
| Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac | Partizione di ripristino Microsoft. |
IsHidden [in]
Se TRUE, la partizione non sarà in grado di ricevere un'assegnazione di lettera di unità, né il gestore di montaggio assegnerà un nome GUID del volume. La partizione non verrà enumerata dalle funzioni FindFirstVolume e FindNextVolume . La partizione può essere aperta in base al nome del dispositivo del volume associato, ad esempio "\\? GLOBALROOT\Device\HarddiskVolumeX").
IsActive [in]
Se TRUE, verrà impostato il bit attivo MBR della partizione e la partizione diventerà avviabile. Questo parametro è valido solo per i dischi MBR.
CreatedPartition [out]
Stringa contenente un oggetto MSFT_Partition incorporato che rappresenta la partizione creata.
ExtendedStatus [out]
Stringa contenente un oggetto MSFT_StorageExtendedStatus incorporato.
Questo parametro consente al provider di archiviazione di restituire informazioni di errore estese (specifiche dell'implementazione).
Valore restituito
Operazione riuscita (0)
Non supportato (1)
Errore non specificato (2)
Timeout (3)
Non riuscito (4)
Parametro non valido (5)
Il disco è in uso (6)
Dimensioni non supportate (4097)
Spazio disponibile insufficiente (40000)
Accesso negato (40001)
Non sono disponibili risorse sufficienti per completare l'operazione. (40002)
Cache non aggiornata (40003)
È necessario specificare una dimensione utilizzando il parametro Size o UseMaximumSize. È possibile specificare solo uno di questi parametri alla volta. (40005)
Il disco non è stato inizializzato. (41000)
Il disco è di sola lettura. (41002)
Il disco è offline. (41003)
È stato raggiunto il limite di partizione del disco. (41004)
L'allineamento della partizione specificato non è valido. Deve essere un multiplo delle dimensioni del settore del disco. (41005)
Un parametro non è valido per questo tipo di partizione. (41006)
Il tipo di partizione specificato non è valido. (41010)
Solo i primi 2 TB sono utilizzabili nei dischi MBR. (41011)
L'offset specificato non è valido. (41012)
Nel dispositivo non sono presenti supporti. (41015)
L'offset specificato non è valido. (41016)
Il layout di partizione specificato non è valido. (41017)
L'oggetto specificato viene gestito dal componente Clustering di failover Microsoft. Il disco deve essere in modalità di manutenzione del cluster e lo stato della risorsa del cluster deve essere online per eseguire questa operazione. (41018)
Il percorso di accesso richiesto è già in uso. (42002)
Impossibile assegnare percorsi di accesso alle partizioni nascoste. (42004)
Il percorso di accesso non è valido. (42007)
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Spazio dei nomi | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |