Metodo IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize (vsmgmt.h)

Articolo
08/27/2023

Il metodo ChangeDiffAreaMaximumSize aggiorna le dimensioni massime dell'area di archiviazione delle copie shadow per un determinato volume. Questo potrebbe non avere un effetto immediato.

Sintassi

HRESULT ChangeDiffAreaMaximumSize(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

Parametri

[in] pwszVolumeName

Nome del volume che rappresenta l'origine delle copie shadow. Questo volume è associato a un'area di archiviazione copia shadow nel volume pwszDiffAreaVolumeName .

Il nome del volume deve essere in uno dei formati seguenti e deve includere una barra rovesciata finale (\):

Percorso di una cartella montata, ad esempio Y:\MountX\
Lettera di unità, ad esempio D:\
Percorso GUID del volume del modulo \\?\Volume{GUID}\ (dove GUID identifica il volume)

[in] pwszDiffAreaVolumeName

Nome del volume contenente l'area di archiviazione copia shadow associata al volume pwszVolumeName .

Il nome del volume deve essere in uno dei formati seguenti e deve includere una barra rovesciata finale (\):

Percorso di una cartella montata
Lettera di unità, ad esempio D:\
Percorso GUID del volume del modulo \\?\Volume{GUID}\ (dove GUID identifica il volume)

[in] llMaximumDiffSpace

Specifica le dimensioni massime, in byte, per l'area di archiviazione copia shadow da usare per il volume. Se questo valore è zero, l'area di archiviazione copia shadow verrà eliminata. Se questo valore è -1, la dimensione massima è illimitata.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	È stata modificata correttamente la dimensione massima dell'area di archiviazione copia shadow.
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_INSUFFICIENT_STORAGE	Il volume pwszDiffAreaVolumeName non dispone di spazio libero sufficiente.
VSS_E_OBJECT_NOT_FOUND	Non è stata trovata l'associazione tra i volumi pwszVolumeName e pwszDiffAreaVolumeName.
VSS_E_PROVIDER_VETO	Errore del provider: il provider ha registrato l'errore nel registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.
VSS_E_VOLUME_IN_USE	Una copia shadow usa attualmente l'area di archiviazione copia shadow.

Commenti

Il metodo ChangeDiffAreaMaximumSize rende esplicita l'area di archiviazione di copia shadow, che significa che non viene eliminata automaticamente quando tutte le copie shadow vengono eliminate.

Se l'area di archiviazione copia shadow non esiste, questo metodo lo crea.

Windows Server 2008, Windows Vista e Windows Server 2003: Se l'area di archiviazione copia shadow non esiste, questo metodo non lo crea.

Per creare un'area di archiviazione copia shadow, usare il metodo IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsmgmt.h

Vedi anche

IVssDifferentialSoftwareSnapshotMgmt

Condividi tramite