DsBackupGetBackupLogs 函数

[此函数可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 从 Windows Vista 开始,请改用卷影复制服务 (VSS) 。]

DsBackupGetBackupLogs 函数获取必须为给定备份上下文备份的日志文件列表。

语法

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

parameters

hbc [in]

包含使用 DsBackupPrepare 函数获取的备份上下文句柄。

pszBackupLogFiles [out]

指向接收日志文件名称列表作为 UNC 路径的字符串指针的指针。 在调用 DsBackupGetBackupLogs 之前,将此值初始化为 NULL

此列表接收单一 null 终止字符串的双 null 终止列表。

此缓冲区由 DsBackupGetBackupLogs 函数分配,并且当不再需要调用 DsBackupFree 函数时必须释放该缓冲区。

每个文件名的第一个字符都包含用于标识名称类型的 BFT 常量 之一。

大小 [out]

指向接收 pszBackupLogFiles 缓冲区大小(以字节为单位)的 DWORD 值的指针。

返回值

如果函数成功或 Win32 或 RPC 错误代码,则返回 S_OK 否则返回。 以下列表列出了其他可能的错误代码。

ERROR_ACCESS_DENIED

调用方没有调用此函数的适当访问权限。 DsSetAuthIdentity 函数可用于设置用于备份和还原函数的凭据。

ERROR_INVALID_PARAMETER

hbcpszBackupLogFileswifiSize 无效。

ERROR_NOT_ENOUGH_MEMORY

发生内存分配失败。

备注

DsBackupGetBackupLogs 函数提供备份所需的日志文件列表。 完整备份由 DsBackupGetDatabaseNames 函数和日志文件提供的数据库文件组成。 不支持 Active Directory 服务器的增量备份。

要求

要求 “值”
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
标头
Ntdsbcli.h

Ntdsbcli.lib
DLL
Ntdsbcli.dll
Unicode 和 ANSI 名称
DsBackupGetBackupLogsW (Unicode) 和 DsBackupGetBackupLogsA (ANSI)

另请参阅

DsBackupFree

DsBackupGetDatabaseNames

BFT 常量

备份 Active Directory 服务器

目录备份函数