Funzione DsBackupGetDatabaseNames
[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 DsBackupGetDatabaseNames ottiene l'elenco dei file di database di cui eseguire il backup per il contesto di backup specificato.
Sintassi
HRESULT DsBackupGetDatabaseNames(
_In_ HBC hbc,
_Out_ LPTSTR *pszAttachmentInfo,
_Out_ LPDWORD pcbSize
);
Parametri
-
hbc [in]
-
Contiene l'handle del contesto di backup ottenuto con la funzione DsBackupPrepare .
-
pszAttachmentInfo [out]
-
Puntatore a un puntatore di stringa che riceve l'elenco di nomi di file di database come percorsi UNC. Questo valore deve essere inizializzato su NULL prima di chiamare DsBackupGetDatabaseNames.
Questo elenco riceve un elenco con terminazione Null doppia di stringhe con terminazione Null singola.
Questo buffer viene allocato dalla funzione DsBackupGetDatabaseNames e deve essere liberato quando non è più richiesto chiamando la funzione DsBackupFree .
Il primo carattere di ogni nome file contiene una delle costanti BFT che identificano il tipo di nome. La funzione DsRestoreGetDatabaseLocations fornisce solo i tipi di nomi seguenti.
-
BFT_NTDS_DATABASE
-
Il file è un file di database NTDS. Questo file deve essere copiato nel file identificato come BFT_NTDS_DATABASE quando i dati vengono ripristinati.
-
BFT_LOG
-
Il file è un file di log. Tutti i file di log vengono copiati nella directory identificata come BFT_LOG_DIR quando i dati vengono ripristinati.
-
BFT_PATCH_FILE
-
Il file è un file patch. Tutti i file di patch vengono copiati nella directory identificata come BFT_CHECKPOINT_DIR quando i dati vengono ripristinati.
pcbSize [out]
Puntatore al valore DWORD che riceve le dimensioni, in byte, del buffer pszAttachmentInfo .
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 altri 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
-
hbc, pszAttachmentInfo o pcbSize non sono validi.
-
ERROR_NOT_ENOUGH_MEMORY
-
Si è verificato un errore di allocazione della memoria.
Commenti
La funzione DsBackupGetDatabaseNames fornisce un elenco dei file di database necessari per un backup. Un backup completo è costituito dai file di database e dai file di log forniti dalla funzione DsBackupGetBackupLogs . I backup incrementali dei server Active Directory non sono supportati.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| Libreria |
|
| DLL |
|
| Nomi Unicode e ANSI |
DsBackupGetDatabaseNamesW (Unicode) e DsBackupGetDatabaseNamesA (ANSI) |