Funzione DsRestoreRegister

[Questa funzione è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. A partire da Windows Vista, usare invece Il servizio copia shadow del volume (VSS).

La funzione DsRestoreRegister registra un'operazione di ripristino. Questa funzione interlocka tutte le operazioni di ripristino successive e impedisce l'avvio della destinazione di ripristino finché non viene chiamata la funzione DsRegisterComplete .

Sintassi

HRESULT DsRestoreRegister(
  _In_ HBC        hbc,
  _In_ LPCTSTR    szCheckPointFilePath,
  _In_ LPCTSTR    szLogPath,
  _In_ EDB_RSTMAP rgrstmap[],
  _In_ LONG       crstmap,
  _In_ LPCTSTR    szBackupLogPath,
  _In_ ULONG      genLow,
  _In_ ULONG      genHigh
);

Parametri

hbc [in]

Contiene l'handle del contesto di ripristino ottenuto con la funzione DsRestorePrepare .

szCheckPointFilePath [in]

Puntatore a una stringa con terminazione null contenente il percorso del file di checkpoint. Questo percorso viene fornito dalla funzione DsRestoreGetDatabaseLocations e ha un valore BFT di BFT_CHECKPOINT_DIR. In genere si tratta dello stesso percorso del database di sistema. Questo percorso è necessario per la funzione di ripristino di backup appropriata. Questo parametro non può essere NULL. Il passaggio di NULL in questo parametro causa un errore durante il processo di ripristino.

szLogPath [in]

Puntatore a una stringa con terminazione null contenente il percorso in cui verranno ripristinati i file di log. Questo percorso viene fornito dalla funzione DsRestoreGetDatabaseLocations e ha un valore BFT di BFT_LOG_DIR. Se il percorso punta a una directory vuota, vengono creati nuovi file di log. Questo parametro non può essere NULL.

rgrstmap [in]

Matrice di strutture EDB_RSTMAP che contiene i percorsi precedenti e nuovi per ogni database. Per ogni database è presente una struttura. Per la directory è presente una struttura per il database di sistema e un'altra struttura per il database della directory. L'ordine degli elementi nella matrice non è importante. Il parametro crstmap contiene il numero di elementi nella matrice.

crstmap [in]

Contiene il numero di elementi nella matrice rgrstmap .

szBackupLogPath [in]

Puntatore a una stringa con terminazione null che contiene il percorso in cui risiede attualmente i file di log di cui è stato eseguito il backup. Questo parametro non può essere NULL.

genLow [in]

Contiene il numero di log più basso da ripristinare in questa sessione di ripristino. Si tratta di un numero esadecimale nell'intervallo compreso tra 0x00000 e 0xFFFFF.

genHigh [in]

Contiene il numero di log più alto da ripristinare in questa sessione di ripristino. Si tratta di un numero esadecimale nell'intervallo compreso tra 0x00000 e 0xFFFFF.

Valore restituito

Restituisce S_OK se la funzione ha esito positivo o un codice di errore Win32 o RPC in caso contrario. Nell'elenco seguente sono elencati i codici di errore possibili.

ERROR_ACCESS_DENIED

Il chiamante non dispone dei privilegi di accesso appropriati per chiamare questa funzione. La funzione DsSetAuthIdentity può essere usata per impostare le credenziali da usare per le funzioni di backup e ripristino.

ERROR_INVALID_PARAMETER

Uno o più parametri non sono validi.

hrMissingExpiryToken

Il token di scadenza fornito a DsRestorePrepare non è valido. Questo valore è definito in Ntdsbmsg.h.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Ntdsbcli.h
Libreria	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Nomi Unicode e ANSI	DsRestoreRegisterW (Unicode) e DsRestoreRegisterA (ANSI)

Vedi anche

DsRestoreRegisterComplete

DsRestorePrepare

DsRestoreGetDatabaseLocations

DsRestoreEnd

EDB_RSTMAP

Ripristino di Active Directory

Funzioni di backup della directory