Metodo IVssCreateWriterMetadata::AddDatabaseLogFiles (vswriter.h)

  • Articolo

Il metodo AddDatabaseLogFiles indica i file di log associati a un database di cui eseguire il backup, nonché il relativo percorso.

Sintassi

HRESULT AddDatabaseLogFiles(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszDatabaseName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] DWORD   dwBackupTypeMask
);

Parametri

[in] wszLogicalPath

Puntatore a una stringa di caratteri wide con terminazione Null contenente il percorso logico del componente di database a cui verranno aggiunti i file di log.

Per altre informazioni, vedere Percorso logico dei componenti.

Un percorso logico non è obbligatorio e può essere NULL.

[in] wszDatabaseName

Puntatore a una stringa di caratteri wide con terminazione Null contenente il nome del componente di database associato ai file di log. Il tipo di questo componente deve essere VSS_CT_DATABASE; in caso contrario, il metodo restituirà un errore.

[in] wszPath

Puntatore a una stringa di caratteri wide con terminazione Null contenente il percorso della directory contenente i file di log.

La directory può essere una directory locale nel computer VSS oppure può essere una directory di condivisione file in un file server remoto.

Sono supportati i percorsi UNC.

Il percorso può contenere variabili di ambiente(ad esempio, %SystemRoot%) ma non può contenere caratteri jolly.

Non è necessario che il percorso termina con una barra rovesciata (""). Spetta alle applicazioni che recuperano queste informazioni da controllare.

[in] wszFilespec

Puntatore a una stringa di caratteri wide con terminazione Null contenente la specifica del file di log dei file di log associati al database.

Una specifica di file non può contenere specifiche di directory (ad esempio, nessuna barra rovesciata) ma può contenere ? e * caratteri jolly.

[in] dwBackupTypeMask

Maschera di bit (o OR bit per bit) di VSS_FILE_SPEC_BACKUP_TYPE valori di enumerazione per indicare se un writer deve valutare il file per la partecipazione a un determinato tipo di operazioni di backup.

Il valore predefinito per questo argomento è (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Valore restituito

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

Valore Significato
S_OK
 L'operazione è stata completata.
E_INVALIDARG
 Uno dei valori dei parametri non è valido oppure il chiamante ha tentato di aggiungere file di database a un componente non di database.
E_OUTOFMEMORY
 Il chiamante non è in memoria o in altre risorse di sistema.
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 specificato 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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Le condivisioni file remote non sono supportate fino a Windows 8 e Windows Server 2012. I writer supportano solo le risorse locali: set di file il cui percorso assoluto inizia con una specifica del volume locale valida e non può essere un'unità di rete mappata. Pertanto, gli input del percorso (wszPath) a AddDatabaseLogFiles (dopo la risoluzione di qualsiasi variabile di ambiente) devono essere in questo formato.

Questo metodo può essere chiamato più volte per un determinato componente di database, che potrebbe essere necessario quando più file di log vengono archiviati in volumi separati.

I valori dei parametri wszLogicalPath e wszDatabaseName devono corrispondere a quelli di uno dei componenti di database aggiunti in precedenza con il metodo IVssCreateWriterMetadata::AddComponent .

Requisiti

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

Vedi anche

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent