Funzione DsBackupGetBackupLogs

[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 DsBackupGetBackupLogs ottiene l'elenco dei file di log di cui è necessario eseguire il backup per il contesto di backup specificato.

Sintassi

HRESULT DsBackupGetBackupLogs(
  _In_  HBC     hbc,
  _Out_ LPTSTR  *pszBackupLogFiles,
  _Out_ LPDWORD pcbSize
);

Parametri

hbc [in]

Contiene l'handle del contesto di backup ottenuto con la funzione DsBackupPrepare .

pszBackupLogFiles [out]

Puntatore a un puntatore di stringa che riceve l'elenco di nomi di file di log come percorsi UNC. Inizializzare questo valore su NULL prima di chiamare DsBackupGetBackupLogs.

Questo elenco riceve un elenco con terminazione Null doppia di stringhe con terminazione Null singola.

Questo buffer viene allocato dalla funzione DsBackupGetBackupLogs e deve essere liberato quando non è più necessario chiamando la funzione DsBackupFree .

Il primo carattere di ogni nome di file contiene una delle costanti BFT che identificano il tipo di nome.

pcbSize [out]

Puntatore al valore DWORD che riceve le dimensioni, in byte, del buffer pszBackupLogFiles .

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, pszBackupLogFiles o pcbSize non è valido.

ERROR_NOT_ENOUGH_MEMORY

Si è verificato un errore di allocazione della memoria.

Commenti

La funzione DsBackupGetBackupLogs fornisce un elenco dei file di log necessari per un backup. Un backup completo è costituito dai file di database forniti dalla funzione DsBackupGetDatabaseNames e dai file di log. 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	Ntdsbcli.h
Libreria	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Nomi Unicode e ANSI	DsBackupGetBackupLogsW (Unicode) e DsBackupGetBackupLogsA (ANSI)

Vedi anche

DsBackupFree

DsBackupGetDatabaseNames

Costanti BFT

Backup di un server Active Directory

Funzioni di backup della directory