struttura CREATE_PARTITION_PARAMETERS (vds.h)

  • Articolo

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Definisce i parametri di partizione di uno stile di partizione.

Sintassi

typedef struct _CREATE_PARTITION_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BYTE    partitionType;
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      GUID      partitionType;
      GUID      partitionId;
      ULONGLONG attributes;
      WCHAR     name[36];
    } GptPartInfo;
  };
} CREATE_PARTITION_PARAMETERS;

Members

style

MbrPartInfo

Parametri per un disco MBR (Master Boot Record). Utilizzato se lo stile è VDS_PST_MBR.

MbrPartInfo.partitionType

Indica il tipo di partizione MBR definito dal sistema. I possibili valori sono i seguenti:

Valore Significato
PARTITION_ENTRY_UNUSED
0x00
 Voce inutilizzata.
PARTITION_FAT_12
0x01
 Specifica una partizione con voci FAT a 12 bit.
PARTITION_XENIX_1
0x02
 Specifica una partizione xenix di tipo 1.
PARTITION_XENIX_2
0x03
 Specifica una partizione xenix di tipo 2.
PARTITION_FAT_16
0x04
 Specifica una partizione con voci FAT a 16 bit.
PARTITION_EXTENDED
0x05
 Specifica una partizione estesa MS-DOS V4.
PARTITION_HUGE
0x06
 Specifica una partizione enorme MS-DOS V4. Questo valore indica che nella partizione non è presente alcun file system Microsoft. Usare questo valore durante la creazione di un volume logico.
PARTITION_IFS
0x07
 Specifica una partizione NTFS o ExFAT.
PARTITION_OS2BOOTMGR
0x0A
 Specifica una partizione di scambio coerente, OPUS o Os/2 Boot Manager.
PARTITION_FAT32
0x0B
 Specifica una partizione FAT32.
PARTITION_FAT32_XINT13
0x0C
 Questo valore non è supportato.
PARTITION_XINT13
0x0E
 Questo valore non è supportato.
PARTITION_XINT13_EXTENDED
0x0F
 Questo valore non è supportato.
PARTITION_PREP
0x41
 Specifica una partizione della piattaforma di riferimento PowerPC.
PARTITION_LDM
0x42
 Specifica una partizione di gestione dischi logica.
PARTITION_UNIX
0x63
 Specifica una partizione UNIX.
PARTITION_NTFT
0x80
 Specifica una partizione NTFT. Questo valore viene usato in combinazione (ovvero bit per bit logicamente ORed) con gli altri valori in questa tabella.

MbrPartInfo.bootIndicator

Se TRUE, la partizione è attiva e può essere avviata; in caso contrario, non è possibile usare la partizione per avviare il sistema.

GptPartInfo

Parametri per un disco GPT (GUID Partition Table). Utilizzato se lo stile è VDS_PST_GPT.

GptPartInfo.partitionType

GUID del tipo di partizione.

Valore Significato
PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
 Non esiste alcuna partizione.

Questo attributo può essere impostato per i dischi di base e dinamici.
PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
 La partizione è una partizione di sistema EFI.

Questo attributo può essere impostato per i dischi di base e dinamici.
PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
 La partizione è una partizione riservata Microsoft.

Questo attributo può essere impostato per i dischi di base e dinamici.
PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
 Tipo di partizione 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.

Questo valore può essere impostato solo per i dischi di base, con un'eccezione. Se sia PARTITION_BASIC_DATA_GUID che GPT_ATTRIBUTE_PLATFORM_REQUIRED sono impostati per una partizione in un disco di base che viene successivamente convertito in un disco dinamico, la partizione rimane una partizione di base, anche se il resto del disco è un disco dinamico. Ciò è dovuto al fatto che la partizione è considerata una partizione OEM in un disco GPT.
PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
 La partizione è una partizione di metadati LDM (Logical Disk Manager) in un disco dinamico.

Questo valore può essere impostato solo per i dischi dinamici.
PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-33111714a69ad
 La partizione è una partizione dati LDM in un disco dinamico.

Questo valore può essere impostato solo per i dischi dinamici.
PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
 La partizione è una partizione di ripristino Microsoft.

Questo attributo può essere impostato per dischi di base e dinamici.

GptPartInfo.partitionId

Se ID della partizione. Se impostato su GUID_NULL (0) sulla creazione, verrà generato un valore univoco.

GptPartInfo.attributes

Attributi della partizione. Questo può essere uno o più dei valori seguenti:

Valore Significato
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
 Se questo attributo è impostato, la partizione è richiesta da un computer per funzionare correttamente.

Ad esempio, questo attributo deve essere impostato per le partizioni OEM. Si noti che se questo attributo è impostato, è possibile usare l'utilità DiskPart.exe per eseguire operazioni di partizione, ad esempio l'eliminazione della partizione. Tuttavia, poiché la partizione non è un volume, non è possibile usare l'utilità DiskPart.exe per eseguire operazioni di volume sulla partizione.

Questo attributo può essere impostato per dischi di base e dinamici. Se è impostato per una partizione in un disco di base e il disco viene convertito in un disco dinamico, la partizione rimane una partizione di base, anche se il resto del disco è un disco dinamico. Ciò avviee perché la partizione viene considerata come una partizione OEM in un disco GPT.
GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
 Se questo attributo è impostato, la partizione non riceve una lettera di unità per impostazione predefinita quando il disco viene spostato in un altro computer o quando il disco viene visualizzato per la prima volta da un computer.

Questo attributo è utile in ambienti di reti di archiviazione (SAN).

Nonostante il nome, questo attributo può essere impostato per dischi di base e dinamici.
GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
 Se questo attributo è impostato, la partizione non viene rilevata da Mount Manager.

Di conseguenza, la partizione non riceve una lettera di unità, non riceve un percorso GUID del volume, non ospita cartelle montate (denominate anche punti di montaggio del volume) e non viene enumerata dalle chiamate a FindFirstVolume e FindNextVolume. In questo modo, le applicazioni come Il defragmenter disco non accedono alla partizione. Il servizio Copia shadow del volume (VSS) usa questo attributo.

Nonostante il nome, questo attributo può essere impostato per dischi di base e dinamici.
GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
 Se questo attributo è impostato, la partizione è una copia shadow di un'altra partizione.

Questo attributo viene usato dal servizio Copia shadow del volume (VSS). Questo attributo è un'indicazione per il software basato su driver di filtro file system (ad esempio programmi antivirus) per evitare l'associazione al volume.

Un'applicazione può usare l'attributo per distinguere un volume di copia shadow da un volume di produzione. Ad esempio, un'applicazione che esegue un ripristino rapido interromperà un LUN di copia shadow cancellando gli attributi di sola lettura e nascosti e questo attributo. Questo attributo viene impostato quando viene creata la copia shadow e cancellata quando la copia shadow viene interrotta.

Nonostante il nome, questo attributo può essere impostato per dischi di base e dinamici.

Windows Server 2003: Questo attributo non è supportato prima di Windows Server 2003 con SP1.
GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
 Se questo attributo è impostato, la partizione è di sola lettura.

Tutte le richieste di scrittura nella partizione avranno esito negativo.
IOCTL_DISK_IS_WRITABLE avrà esito negativo con il codice di errore ERROR_WRITE_PROTECT Win32, che causa il montaggio del file system come di sola lettura, se è presente un file system.

VSS usa questo attributo.

Non impostare questo attributo per i dischi dinamici. L'impostazione può causare errori di I/O e impedire il montaggio corretto del file system.

GptPartInfo.name[36]

Stringa Unicode con terminazione null che specifica il nome della partizione.

Commenti

Il metodo IVdsAdvancedDisk::CreatePartition passa questa struttura come argomento per specificare un set di parametri.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione vds.h

Vedi anche

IVdsAdvancedDisk::CreatePartition

Strutture VDS

VDS_PARTITION_STYLE