Funzione DsBackupOpenFile

[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 DsBackupOpenFile apre il file specificato ed esegue le operazioni client e server necessarie per preparare il file per il backup.

Sintassi

HRESULT DsBackupOpenFile(
  _In_  HBC           hbc,
  _In_  LPCTSTR       szAttachmentName,
  _In_  DWORD         cbReadHintSize,
  _Out_ LARGE_INTEGER *pliFileSize
);

Parametri

hbc [in]

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

szAttachmentName [in]

Puntatore a una stringa con terminazione null che specifica il nome del file di backup da aprire.

cbReadHintSize [in]

Contiene le dimensioni possibili, in byte, del buffer passato come argomento pvBuffer nella funzione DsBackupRead . Le funzioni di backup usano questo valore come hint per ottimizzare il traffico di rete. Questo valore deve essere un multiplo di 8192 e deve essere maggiore o uguale a 24576.

pliFileSize [out]

Puntatore a un valore LARGE_INTEGER che riceve le dimensioni, in byte, del file di backup aperto.

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, szAttachmentName o pliFileSize non sono validi.

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	DsBackupOpenFileW (Unicode) e DsBackupOpenFileA (ANSI)

Vedi anche

DsBackupRead

Backup di un server Active Directory

Funzioni di backup della directory