Metodo IVssBackupComponents::AddRestoreSubcomponent (vsbackup.h)

Articolo
03/08/2023

Il metodo AddRestoreSubcomponent indica che un membro del sottocomponente di un set di componenti, contrassegnato come non selezionabile per il backup ma contrassegnato come selezionabile per il ripristino, deve essere ripristinato indipendentemente dal fatto che venga ripristinato qualsiasi altro membro del set di componenti.

Sintassi

HRESULT AddRestoreSubcomponent(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE componentType,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszSubComponentLogicalPath,
  [in] LPCWSTR            wszSubComponentName,
  [in] bool               bRepair
);

Parametri

[in] writerId

Identificatore della classe writer.

[in] componentType

Identifica il tipo del componente. Per informazioni sui possibili valori restituiti, vedere la documentazione per VSS_COMPONENT_TYPE .

[in] wszLogicalPath

Stringa di caratteri wide con terminazione Null contenente il percorso logico del componente nel documento di backup che definisce il set di componenti di backup contenente il sottocomponente da aggiungere per il ripristino.

Il valore di questo parametro può essere NULL.

Non esistono restrizioni sui caratteri che possono essere visualizzati in un percorso logico non NULL .

[in] wszComponentName

Il valore di questo parametro non può essere NULL.

Non esistono restrizioni sui caratteri che possono essere visualizzati in un nome di componente non NULL .

[in] wszSubComponentLogicalPath

Stringa di caratteri wide con terminazione Null contenente il percorso logico del sottocomponente da aggiungere per il ripristino.

Quando si aggiunge un sottocomponente, è necessario un percorso logico. Pertanto, il valore di questo parametro non può essere NULL.

Non esistono restrizioni sui caratteri che possono essere visualizzati in un percorso logico non NULL .

[in] wszSubComponentName

Stringa di caratteri wide con terminazione Null contenente il nome logico del sottocomponente da aggiungere per il ripristino.

Il valore di questo parametro non può essere NULL.

Non esistono restrizioni sui caratteri che possono essere visualizzati in un nome di componente non NULL .

[in] bRepair

Questo parametro è riservato per usi futuri. Questo parametro deve essere sempre impostato su false

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	Aggiunta del sottocomponente di ripristino completata.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_BAD_STATE	L'oggetto componenti di backup non viene inizializzato, questo metodo non è stato chiamato durante un'operazione di ripristino oppure questo metodo non è stato chiamato all'interno della sequenza corretta.
VSS_E_INVALID_XML_DOCUMENT	Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_OBJECT_NOT_FOUND	Il componente non esiste.
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.

Commenti

Prima di chiamare AddRestoreSubcomponent, il componente radice definito dai parametri wszLogicalPath e wszComponentName deve essere prima selezionato per il ripristino usando IVssBackupComponents::SetSelectedForRestore.

Se un richiedente supporta il ripristino dei sottocomponenti, questo metodo deve essere chiamato prima di IVssBackupComponents::P reRestore.

AddRestoreSubcomponent è destinato al caso in cui tutti i file nel set di componenti di un writer devono essere sottoposti a backup come unità, ma dove è consigliabile che i file selezionati (sottocomponenti) siano in grado di essere ripristinati singolarmente.

Per partecipare a tale ripristino, un sottocomponente deve avere il membro bSelectableForRestore di VSS_COMPONENTINFO impostato su TRUE. Il componente definito dai parametri wszLogicalPath e wszComponentName deve essere selezionato anche per il ripristino usando IVssBackupComponents::SetSelectedForRestore.

Per altre informazioni, vedere Working with Selectability for Restore and Subcomponents .See Working with Selectability for Restore and Subcomponents for More information.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssBackupComponents

IVssBackupComponents::P reRestore

VSS_COMPONENT_TYPE