IFileSyncProvider::Initialize

Articolo
09/18/2009

Inizializza una nuova istanza di IFileSyncProvider basata sulla cartella da sincronizzare e su altre impostazioni.

HRESULT Initialize(
  REFGUID guidReplicaId,
  LPCWSTR pcszReplicaRootPath,
  LPCWSTR pcszMetadataFilePath,
  LPCWSTR pcszTempDirectoryPath,
  DWORD dwSyncFlags,
  IFileSyncScopeFilter *pScopeFilter,
  IFileSyncProviderCallback *pCallback,
  LPCWSTR pcszPathToSaveConflictLoserFiles);

Parametri

guidReplicaId
[in] ID della replica.

pcszReplicaRootPath
[in, string] Percorso assoluto dell'archivio file locale per questo provider. Si tratta della cartella contenente i file e le sottocartelle da sincronizzare.

pcszMetadataFilePath
[in, string] Percorso assoluto e nome del file dell'archivio dei metadati. È necessario creare la directory prima di chiamare questo costruttore. Tramite l'applicazione è necessario assicurarsi che la directory sia protetta con il livello appropriato di autorizzazioni di protezione per impedire la divulgazione delle informazioni.

pcszTempDirectoryPath
[in, string] Percorso assoluto in cui verranno archiviati i file temporanei. È necessario creare la directory prima di chiamare questo costruttore. Tramite l'applicazione è necessario assicurarsi che la directory sia protetta con il livello appropriato di autorizzazioni di protezione per impedire la divulgazione delle informazioni. Se pcszTempDirectoryPath è NULL o una stringa vuota, i file temporanei verranno archiviati nel percorso specificato da pcszReplicaRootPath.

dwSyncFlags
[in] Flag che determinano il comportamento del provider durante la sincronizzazione. Questo valore deve essere dato da una combinazione di valori dall'enumerazione FILESYNC_INIT_FLAGS.

pScopeFilter
[in, unique] Filtro ambito statico che specifica i file o le directory nell'archivio file locale da includere nell'ambito. Può essere NULL.

pCallback
[in, unique] Interfaccia di callback che riceve notifiche sullo stato di avanzamento e sullo stato dal provider. Può essere NULL.

pcszPathToSaveConflictLoserFiles
[in, string] Percorso assoluto in cui verranno archiviati i file delle righe in conflitto ignorate. È necessario creare la directory prima di chiamare questo costruttore. Per impedire la divulgazione delle informazioni, è necessario assicurarsi tramite l'applicazione che tale directory sia protetta con il livello appropriato di autorizzazioni di protezione. Può essere NULL.

Valore restituito

S_OK
SYNC_E_FSP_INVALIDOPERATION se Initialize è già stato chiamato.
E_INVALIDARG se nessuno dei percorsi specificati è un percorso relativo o non esiste o se il percorso dei metadati non include il nome del file dei metadati.
SYNC_E_METADATA_REPLICA_IN_USE se un'istanza di IReplicaMetadata che rappresenta l'ID replica specificato da guidReplicaId e l'archivio dei metadati specificato da pcszMetadataFilePath esiste già in un altro processo.

Osservazioni

Le informazioni passate ai costruttori vengono utilizzate per l'inizializzazione e impostate per tutta la durata dell'istanza del provider. Pertanto, in caso di modifica delle impostazioni, sarà necessario creare una nuova istanza del provider. Ad esempio, per modificare il filtro ambito utilizzato per la sincronizzazione, è necessario creare un nuovo provider di sincronizzazione dei file e inizializzarlo con il nuovo filtro.

Sync Services for File Systems utilizza il servizio di archiviazione dei metadati per archiviare tutti i metadati di sincronizzazione in un database lightweight. Il database dei metadati è un file che può essere archiviato con i file e le cartelle da sincronizzare o in un percorso diverso specificato in Initialize.

Per assicurare una protezione adeguata, directory come la directory temporanea devono essere protette con il livello appropriato di autorizzazioni per impedire la divulgazione delle informazioni.

Vedere anche

Riferimento

Interfaccia IFileSyncProvider
Enumerazione FILESYNC_INIT_FLAGS

Condividi tramite