Metodo IVdsAdvancedDisk::CreatePartition (vds.h)

Articolo
03/08/2023

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

Crea una partizione su un disco di base.

Il metodo IVdsCreatePartitionEx::CreatePartitionEx sostituisce questo metodo.

Sintassi

HRESULT CreatePartition(
  [in]  ULONGLONG                   ullOffset,
  [in]  ULONGLONG                   ullSize,
  [in]  CREATE_PARTITION_PARAMETERS *para,
  [out] IVdsAsync                   **ppAsync
);

Parametri

[in] ullOffset

Offset della partizione.

[in] ullSize

Dimensione, in byte, della nuova partizione.

[in] para

Puntatore ai parametri definiti dalla struttura CREATE_PARTITION_PARAMETERS .

[out] ppAsync

Indirizzo di un puntatore all'interfaccia IVdsAsync , che il VDS inizializza al momento della restituzione. I chiamanti devono rilasciare l'interfaccia. Usare questo puntatore per annullare, attendere o eseguire una query sullo stato dell'operazione.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice/valore restituito	Descrizione
S_OK	La partizione è stata creata correttamente.
VDS_E_NO_MEDIA 0x80042412L	Nessun supporto in un'unità rimovibile.
VDS_E_INVALID_OPERATION 0x80042415L	Il supporto non supporta questa operazione. Ad esempio, il chiamante non può creare una partizione in un CD-ROM.
VDS_E_NOT_SUPPORTED 0x80042400L	La creazione di una seconda partizione su supporti rimovibili non è supportata. In alternativa, questo errore indica che il disco è un disco dinamico.
VDS_E_PARTITION_LIMIT_REACHED 0x80042407L	Il numero massimo di partizioni (quattro primarie o tre primarie e una estesa) esiste già quando il chiamante tenta di creare una partizione primaria aggiuntiva o una partizione estesa.
VDS_S_UPDATE_BOOTFILE_FAILED 0x00042434L	La partizione è stata creata correttamente, ma VDS non è riuscito ad aggiornare le opzioni di avvio nell'archivio dei dati di configurazione di avvio (BCD). Windows Server 2003: Le opzioni di avvio vengono archiviate nel file boot.ini in un sistema x86 o x64 o NVRAM in un sistema Itanium.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Libreria	Uuid.lib

Vedi anche

CREATE_PARTITION_PARAMETERS

Oggetto Disk

IVdsAdvancedDisk

IVdsAsync

IVdsCreatePartitionEx::CreatePartitionEx

Condividi tramite