DsBackupGetBackupLogs 函数

[此函数可用于“要求”部分中指定的操作系统。在后续版本中，它可能会被修改，也可能无法使用。从 Windows Vista 开始，请改用卷影复制服务（VSS）。

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

语法

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

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: hbc、 pszBackupLogFiles 或 wifiSize 无效。
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）