Metodo IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx (vsmgmt.h)

Articolo
08/27/2023

Aggiornamenti la dimensione massima massima dell'area di archiviazione copia shadow per un determinato volume. Questo potrebbe non avere un effetto immediato. Se il parametro bVolatile è FALSE, la modifica continua anche se il computer viene riavviato.

Sintassi

HRESULT ChangeDiffAreaMaximumSizeEx(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace,
  [in] BOOL     bVolatile
);

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à con, 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.

[in] bVolatile

TRUE per indicare che l'effetto della chiamata al metodo ChangeDiffAreaMaximumSizeEx non deve continuare se il computer viene riavviato; in caso contrario, FALSE.

Il valore predefinito è FALSE.

Se il parametro llMaximumDiffSpace è zero, il parametro bVolatile deve essere FALSE.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	La dimensione massima dell'area di archiviazione copia shadow è stata modificata correttamente.
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	Si è verificato un errore previsto del provider. Il codice di errore viene registrato 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 ChangeDiffAreaMaximumSizeEx è identico al metodo IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize , ad eccezione del parametro bVolatile .

La chiamata al metodo ChangeDiffAreaMaximumSizeEx con il parametro bVolatile impostata su FALSE equivale a chiamare il metodo ChangeDiffAreaMaximumSize .

ChangeDiffAreaMaximumSizeEx 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 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsmgmt.h

Vedi anche

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize

Condividi tramite