Funzione ExpandVirtualDisk (virtdisk.h)

Aumenta le dimensioni di un disco rigido virtuale fisso o dinamicamente espandibile.

Sintassi

DWORD ExpandVirtualDisk(
  [in]           HANDLE                          VirtualDiskHandle,
  [in]           EXPAND_VIRTUAL_DISK_FLAG        Flags,
  [in]           PEXPAND_VIRTUAL_DISK_PARAMETERS Parameters,
  [in, optional] LPOVERLAPPED                    Overlapped
);

Parametri

[in] VirtualDiskHandle

Handle per il disco virtuale aperto, che deve essere stato aperto usando il flag di VIRTUAL_DISK_ACCESS_METAOPS . Per informazioni su come aprire un disco virtuale, vedere la funzione OpenVirtualDisk .

[in] Flags

Deve essere il valore EXPAND_VIRTUAL_DISK_FLAG_NONE dell'enumerazione EXPAND_VIRTUAL_DISK_FLAG .

[in] Parameters

Puntatore a una struttura di EXPAND_VIRTUAL_DISK_PARAMETERS valida che contiene i dati dei parametri di espansione.

[in, optional] Overlapped

Puntatore facoltativo a una struttura OVERLAPPED valida se si desidera un'operazione asincrona .

Valore restituito

Stato della richiesta.

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore. Per altre informazioni, vedere Codici di errore di sistema.

Commenti

La funzione ExpandVirtualDisk esegue l'operazione sul posto e quindi non crea un disco virtuale.

L'operazione di espansione è valida solo per dischi virtuali fissi ed espandibili e invaliderà una catena di dischi virtuali diversa.

L'espansione di un disco virtuale richiede che il disco virtuale venga scollegato durante l'operazione.

Il chiamante deve avere READ|ACCESSO WRITE all'archivio di backup per il disco virtuale.

Per un disco virtuale espandibile, la funzione ExpandVirtualDisk potrebbe non comportare un file più grande perché la dimensione è virtuale e non aumenterebbe fisicamente fino all'uso.

Se il disco virtuale è espandibile e il volume host non dispone di spazio sufficiente per le nuove dimensioni, la funzione ExpandVirtualDisk può avere esito positivo comunque. Le operazioni di scrittura future nel disco virtuale potrebbero non riuscire se il volume host viene esaurito quando il disco virtuale si espande.

Requisiti

Vedi anche

Informazioni sul disco rigido virtuale

Informazioni di riferimento sul disco rigido virtuale