Metodo IVssCreateExpressWriterMetadata::AddFilesToFileGroup (vswriter.h)

Articolo
08/27/2023

Aggiunge un set di file (un file o file specificato) a un componente del gruppo di file specificato per un writer express.

Sintassi

HRESULT AddFilesToFileGroup(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszGroupName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive,
  [in] LPCWSTR wszAlternateLocation,
  [in] DWORD   dwBackupTypeMask
);

Parametri

[in] wszLogicalPath

Puntatore a una stringa di caratteri wide con terminazione Null contenente il percorso logico (che può essere NULL) del componente a cui aggiungere i file. Per altre informazioni, vedere Percorso logico dei componenti.

[in] wszGroupName

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

[in] wszPath

Puntatore a una stringa di caratteri wide con terminazione Null contenente la directory radice predefinita dei file da aggiungere.

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

Non è necessario che il percorso venga terminato 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 di file dei file da includere.

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

[in] bRecursive

Valore booleano che specifica se il percorso specificato dal parametro wszPath identifica solo una singola directory o se indica una gerarchia di directory da attraversare in modo ricorsivo. Questo parametro deve essere impostato su true se il percorso viene considerato come una gerarchia di directory da modificare o false in caso contrario.This parameter should be set to true if the path is treated as a hierarchy of directories to be recursed through, or false otherwise.

Per informazioni sull'attraversamento di cartelle montate, vedere Utilizzo di cartelle montate e Reparse Points.

[in] wszAlternateLocation

Questo parametro è riservato e deve essere NULL.

[in] dwBackupTypeMask

Maschera di bit di VSS_FILE_SPEC_BACKUP_TYPE valori di enumerazione per indicare se un writer deve valutare la partecipazione del file a un determinato tipo di operazioni di backup.

Questo parametro non può includere VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED o VSS_FSBT_LOG_BACKUP_REQUIRED.

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 o il chiamante ha tentato di aggiungere file di gruppo a un componente non di filegroup.
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.

Requisiti


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

Vedi anche

IVssCreateExpressWriterMetadata

Condividi tramite