Metodo ResizeVirtualHardDisk della classe Msvm_ImageManagementService

Ridimensiona un disco rigido virtuale esistente. Il disco rigido virtuale deve essere offline. Per questo metodo, vedere la sezione Osservazioni relative alle restrizioni di utilizzo.

Sintassi

uint32 ResizeVirtualHardDisk(
  [in]  string              Path,
  [in]  uint64              MaxInternalSize,
  [out] CIM_ConcreteJob REF Job
);

Parametri

Percorso [in]

Tipo: string

Percorso completo del file del disco rigido virtuale.

MaxInternalSize [in]

Tipo: uint64

Dimensioni massime del disco rigido virtuale visualizzabili dalla macchina virtuale, in byte. Il valore minimo maxInternalSize è DiskSize + 512 - (DiskSize mod 512). DiskSize è la dimensione del file del disco rigido virtuale, in byte. L'errore InvalidParameter (32773) viene restituito se il valore MaxInternalSize specificato è minore del valore minimo.

Processo [out]

Tipo: CIM_ConcreteJob

Se l'operazione viene eseguita in modo asincrono, questo metodo restituirà 4096 e questo parametro conterrà un riferimento a un oggetto derivato da CIM_ConcreteJob.

Valore restituito

Tipo: uint32

Questo metodo può restituire uno dei valori seguenti.

Completata senza errore (0)

Parametri del metodo controllati - Processo avviato (4096)

Non riuscito (32768)

Accesso negato (32769)

Non supportato (32770)

Lo stato è sconosciuto (32771)

Timeout (32772)

Parametro non valido (32773)

Il sistema è in uso (32774)

Stato non valido per questa operazione (32775)

Tipo di dati non corretto (32776)

Sistema non disponibile (32777)

Memoria insufficiente (32778)

File non trovato (32779)

Commenti

Solo i tipi seguenti di dischi rigidi virtuali possono essere usati con questo metodo quando vengono aumentate le dimensioni del disco rigido virtuale:

• Correzione del disco rigido virtuale
• Correzione di VHDX
• Disco rigido virtuale dinamico
• VHDX dinamico
• VHDX differenze

Solo i seguenti tipi di dischi rigidi virtuali possono essere usati con questo metodo quando le dimensioni del disco rigido virtuale vengono ridotte:

• Correzione di VHDX
• VHDX dinamico
• VHDX differenze

L'accesso alla classe Msvm_ImageManagementService potrebbe essere limitato dal filtro controllo dell'account utente. Per altre informazioni, vedere Controllo dell'account utente e WMI.

Esempio

L'esempio C# seguente espande un file del disco rigido virtuale. Le utilità a cui si fa riferimento sono disponibili in Utilità comuni per gli esempi di virtualizzazione (V2).

const UInt64 size1G = 0x40000000;

public static void ResizeVirtualHardDisk(string path, UInt64 maxInternalSize)
{
    ManagementScope scope = new ManagementScope(@"root\virtualization\V2", null);
    ManagementObject imageService = Utility.GetServiceObject(scope, "Msvm_ImageManagementService");

    ManagementBaseObject inParams = imageService.GetMethodParameters("ResizeVirtualHardDisk");
    inParams["Path"] = path;
    inParams["MaxInternalSize"] = maxInternalSize * size1G;
    ManagementBaseObject outParams = imageService.InvokeMethod("ResizeVirtualHardDisk", inParams, null);
    if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
    {
        if (Utility.JobCompleted(outParams, scope))
        {
            Console.WriteLine("{0} was resized successfully.", inParams["Path"]);
        }
        else
        {
            Console.WriteLine("Unable to resize {0}", inParams["Path"]);
        }
    }

    outParams.Dispose();
    inParams.Dispose();
    imageService.Dispose();
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Spazio dei nomi	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Vedi anche

CIM_ConcreteJob

Msvm_ImageManagementService