Função DsBackupOpenFile
[Essa função está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. A partir do Windows Vista, use o VSS (Serviço de Cópia de Sombra de Volume).
A função DsBackupOpenFile abre o arquivo especificado e executa as operações de cliente e servidor necessárias para preparar o arquivo para backup.
Sintaxe
HRESULT DsBackupOpenFile(
_In_ HBC hbc,
_In_ LPCTSTR szAttachmentName,
_In_ DWORD cbReadHintSize,
_Out_ LARGE_INTEGER *pliFileSize
);
Parâmetros
-
hbc [in]
-
Contém o identificador de contexto de backup obtido com a função DsBackupPrepare .
-
szAttachmentName [in]
-
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do arquivo de backup a ser aberto.
-
cbReadHintSize [in]
-
Contém o tamanho possível, em bytes, do buffer passado como o argumento pvBuffer na função DsBackupRead . As funções de backup usam esse valor como uma dica para otimizar o tráfego de rede. Esse valor deve ser um múltiplo de 8192 e deve ser maior ou igual a 24576.
-
pliFileSize [out]
-
Ponteiro para um valor LARGE_INTEGER que recebe o tamanho, em bytes, do arquivo de backup aberto.
Valor retornado
Retorna S_OK se a função for bem-sucedida ou um código de erro Win32 ou RPC, caso contrário. A lista a seguir lista outros códigos de erro possíveis.
-
ERROR_ACCESS_DENIED
-
O chamador não tem os privilégios de acesso adequados para chamar essa função. A função DsSetAuthIdentity pode ser usada para definir as credenciais a serem usadas para as funções de backup e restauração.
-
ERROR_INVALID_PARAMETER
-
hbc, szAttachmentName ou pliFileSize são inválidos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|
| Nomes Unicode e ANSI |
DsBackupOpenFileW (Unicode) e DsBackupOpenFileA (ANSI) |