Metodo IVssBackupComponentsEx::SetSelectedForRestoreEx (vsbackup.h)

  • Articolo

Il metodo SetSelectedForRestoreEx indica se il componente selezionabile specificato è selezionato per il ripristino in un'istanza di writer specificata.

Sintassi

HRESULT SetSelectedForRestoreEx(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bSelectedForRestore,
  [in] VSS_ID             instanceId
);

Parametri

[in] writerId

Identificatore univoco globale (GUID) della classe writer.

[in] ct

Tipo del componente. Per i valori possibili, vedere VSS_COMPONENT_TYPE .

[in] wszLogicalPath

Stringa di caratteri wide con terminazione Null contenente il percorso logico del componente. Per altre informazioni, vedere Percorso logico dei componenti.

Il valore della stringa contenente il percorso logico usato qui deve essere uguale a quello usato quando è stato aggiunto il componente.

Il percorso logico può essere NULL.

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

[in] wszComponentName

Stringa di caratteri wide con terminazione null contenente il nome del componente.

La stringa non può essere NULL e deve contenere lo stesso nome del componente usato quando il componente è stato aggiunto al set di backup usando il metodo IVssBackupComponents::AddComponent.

[in] bSelectedForRestore

Se il valore di questo parametro è true, il componente selezionato è stato selezionato per il ripristino. Se il valore è false, il componente selezionato non è stato selezionato per il ripristino.

[in] instanceId

GUID dell'istanza del writer.

Il valore predefinito per questo parametro è GUID_NULL.

Valore restituito

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

Valore Significato
S_OK
 È stato indicato che il componente specificato è stato selezionato per essere ripristinato.
E_INVALIDARG
 Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
 Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE
 L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino o questo metodo non è stato chiamato all'interno della sequenza corretta.
VSS_E_OBJECT_NOT_FOUND
 Il componente selezionato non esiste nel documento Componenti di backup o un'istanza attiva del writer corrispondente a tale componente non è in esecuzione nel sistema.
VSS_E_INVALID_XML_DOCUMENT
 Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. 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.

Commenti

SetSelectedForRestoreEx, che sposta un componente in un'istanza di writer diversa, può essere chiamato solo per un writer che supporta l'esecuzione di più istanze di writer con lo stesso ID classe e supporta lo spostamento di un componente in un'istanza di writer diversa in fase di ripristino. Per determinare se un writer fornisce questo supporto, chiamare il metodo IVssExamineWriterMetadata::GetBackupSchema .

SetSelectedForRestoreEx ha significato solo per i ripristini in modalità componente.

SetSelectedForRestoreEx può essere chiamato solo per i componenti aggiunti in modo esplicito al documento di backup in fase di backup usando AddComponent. Il ripristino di un componente selezionato in modo implicito per il backup come parte di un set di componenti deve essere eseguito chiamando SetSelectedForRestoreEx nel componente predecessore più vicino aggiunto al documento. Se solo i dati di questo componente devono essere ripristinati, che devono essere eseguiti tramite il metodo IVssBackupComponents::AddRestoreSubcomponent ; questa operazione può essere eseguita solo se il componente è selezionabile per il ripristino (vedere Uso di Selezionabilità e Percorsi logici).

Questo metodo deve essere chiamato prima del metodo IVssBackupComponents::P reRestore .

La distinzione tra i parametri instanceId e writerID è necessaria perché è possibile che più istanze dello stesso writer siano in esecuzione nel computer.

Se il valore del parametro instanceId è GUID_NULL, questo equivale a chiamare il metodo IVssBackupComponents::SetSelectedForRestore .

Il parametro instanceId viene usato per specificare che il componente deve essere ripristinato in un'istanza di writer diversa. Se il valore del parametro instanceId non è GUID_NULL, deve corrispondere all'ID istanza di un'istanza di un writer con lo stesso ID classe writer specificato nel parametro writerID .

È possibile trovare l'identificatore di classe, l'identificatore dell'istanza e il nome dell'istanza di un writer chiamando il metodo IVssExamineWriterMetadataEx::GetIdentityEx .

Requisiti

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

Vedi anche

IVssBackupComponents::SetSelectedForRestore

IVssBackupComponentsEx

IVssExamineWriterMetadata::GetBackupSchema

IVssExamineWriterMetadataEx::GetIdentityEx