Funzione FhServiceStartBackup (fhsvcctl.h)

Questa funzione avvia un backup immediato per l'utente corrente.

Sintassi

HRESULT FhServiceStartBackup(
  [in] FH_SERVICE_PIPE_HANDLE Pipe,
  [in] BOOL                   LowPriorityIo
);

Parametri

[in] Pipe

Handle del canale di comunicazione restituito da una chiamata FhServiceOpenPipe precedente.

[in] LowPriorityIo

Se TRUE, il servizio Cronologia file viene indicato di usare operazioni di I/O con priorità bassa per il backup immediato pianificato da questa funzione. L'I/O con priorità bassa riduce l'impatto sulle attività utente in primo piano. È consigliabile impostare questo parametro su TRUE.

Se FALSE, il servizio Cronologia file viene indicato di usare le operazioni di I/O con priorità normale per il backup immediato pianificato da questa funzione. Ciò comporta backup più veloci, ma influisce negativamente sulla velocità di risposta e sulle prestazioni delle applicazioni utente.

Valore restituito

S_OK in caso di esito positivo o un HRESULT non riuscito in caso di errore. I valori HRESULT possibili non riusciti includono i valori definiti nel file di intestazione FhErrors.h.

Commenti

Questa funzione non attende il completamento del backup immediato. Se si verifica un errore o una condizione di avviso durante il backup, viene comunicato all'utente tramite una notifica del Centro notifiche e recuperabile a livello di codice tramite il metodo IFhConfigMgr::QueryProtectionStatus .

Un ciclo di backup avviato chiamando questa funzione può essere arrestato usando la funzione FhServiceStopBackup .

Requisiti

Vedi anche

FhServiceOpenPipe

FhServiceStopBackup

IFhConfigMgr::QueryProtectionStatus