Condividi tramite

Metodo IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea (vsmgmt.h)

  • Articolo

Il metodo AddDiffArea aggiunge un'associazione dell'area di archiviazione shadow per il volume specificato. Se l'associazione non è supportata, verrà restituito un codice di errore.

Sintassi

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

Parametri

[in] pwszVolumeName

Nome del volume che sarà 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 che conterrà l'area di archiviazione copia shadow da associare 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

Dimensioni massime, in byte, dell'area di archiviazione copia shadow nel volume. Questo valore deve essere almeno 320 MB, fino al limite a livello di sistema. Se questo valore è -1, la dimensione massima è illimitata.

Windows Server 2003: Prima di Windows Server 2003 con SP1, la dimensione dell'area di archiviazione delle copie shadow è stata fissa a 100 MB.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Significato
S_OK
 Aggiunta dell'associazione dell'area di archiviazione di 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_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED
 Il numero massimo di aree di archiviazione di copia shadow è stato aggiunto al volume di origine copia shadow. Il volume di archiviazione di copia shadow specificato non è stato associato al volume di origine di copia shadow specificato.
VSS_E_NESTED_VOLUME_LIMIT
 Il volume specificato è annidato troppo profondamente per partecipare all'operazione VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo codice restituito non è supportato.
VSS_E_OBJECT_ALREADY_EXISTS
 Esiste già l'associazione tra i volumi pwszVolumeName e pwszDiffAreaVolumeName.
VSS_E_PROVIDER_VETO
 Errore previsto 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_NOT_SUPPORTED
 Il volume pwszDiffAreaVolumeName non è un volume NTFS o ha spazio libero insufficiente.

Commenti

Non è possibile creare un'associazione dell'area di archiviazione copia shadow se esistono già copie shadow per il volume pwszVolumeName o se è già presente un'associazione dell'area di archiviazione shadow per tale volume.

L'area di archiviazione copia shadow per un volume di origine del disco rigido virtuale deve risiedere nello stesso volume. Analogamente, un'area di archiviazione copia shadow può essere creata solo in un volume VHD se il volume di origine è uguale per entrambi i volumi.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: I dischi rigidi virtuali non sono supportati.

Per modificare le dimensioni di un'area di archiviazione copia shadow, usare il metodo IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize o IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx. È possibile eliminare un'area di archiviazione copia shadow modificandone le dimensioni su zero.

Requisiti

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

Vedi anche

IVssDifferentialSoftwareSnapshotMgmt