Funzione DsRestorePrepare
[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 DsRestorePrepare si connette al server directory specificato e la prepara per l'operazione di ripristino.
Sintassi
HRESULT DsRestorePrepare(
_In_ LPCWSTR szServerName,
_In_ ULONG rtFlag,
_In_ PVOID pvExpiryToken,
_In_ DWORD cbExpiryTokenSize,
_Out_ HBC *phbc
);
Parametri
-
szServerName [in]
-
Puntatore a una stringa con terminazione null contenente il nome del server da ripristinare. Le barre rovesciata precedenti sono facoltative. Il server deve essere lo stesso computer da cui viene chiamata questa funzione. Il nome del server non può contenere caratteri di sottolineatura (_). Un esempio di nome server è "\\server1".
-
rtFlag [in]
-
Specifica il tipo di ripristino da eseguire. Questo può essere zero o uno dei valori seguenti.
-
RESTORE_TYPE_CATCHUP
-
Valore predefinito. La versione ripristinata viene riconciliata tramite la logica di riconciliazione standard in modo che il DIT ripristinato possa essere sincronizzato con altri computer server aziendali.
-
RESTORE_TYPE_AUTHORATATIVE
-
Non supportato.
-
RESTORE_TYPE_ONLINE
-
Non supportato. Il ripristino viene eseguito quando NTDS è online.
pvExpiryToken [in]
Puntatore al token di scadenza associato al backup da ripristinare. Questo token è stato ottenuto dalla funzione DsBackupPrepare quando la directory è stata eseguita il backup.
Se questo parametro è NULL, l'handle restituito in phbc può essere usato solo per ottenere le directory di ripristino con la funzione DsRestoreGetDatabaseLocations . Impossibile usare l'handle per altre funzioni di ripristino.
cbExpiryTokenSize [in]
Contiene le dimensioni, in byte, del token di scadenza in pvExpiryToken.
phbc [out]
Puntatore a un valore HBC che riceve l'handle per il ripristino. Questo handle viene usato quando si chiamano altre funzioni di ripristino del servizio directory, ad esempio DsBackupOpenFile e DsRestoreEnd.
Valore restituito
Se ha esito positivo, restituisce un codice HRESULT standard; in caso contrario, viene restituito un codice di errore.
Commenti
La funzione DsRestorePrepare richiede che il chiamante sia membro del gruppo Administrators nel server.
DsRestorePrepare può essere usato con o senza token fornito. Se viene fornito il token, viene controllato per la scadenza e tutte le operazioni sono consentite nel contesto restituito. Se il token non viene specificato, il contesto restituito è limitato e può essere usato solo per la funzione DsRestoreGetDatabaseLocations . Potrebbe non essere usato per la funzione DsRestoreRegister .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| Libreria |
|
| DLL |
|
| Nomi Unicode e ANSI |
DsRestorePrepareW (Unicode) e DsRestorePrepareA (ANSI) |