DsBackupRead 函数

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

DsBackupRead 函数将当前打开的文件中的数据块读取到缓冲区中。客户端应用程序应重复调用此函数，直到收到整个备份文件。 DsBackupOpenFile 函数提供备份文件的整个大小。

语法

HRESULT DsBackupRead(
  _In_  HBC    hbc,
  _In_  PVOID  pvBuffer,
  _In_  DWORD  cbBuffer,
  _Out_ PDWORD pcbRead
);

hbc [in]: 包含使用 DsBackupPrepare 函数获取的备份上下文句柄。
pvBuffer [in]: 指向接收数据的缓冲区的指针。此缓冲区的大小必须至少 为 cbBuffer 字节。
cbBuffer [in]: 包含 pvBuffer 缓冲区的大小（以字节为单位）。此值必须是 8192 的倍数，并且必须大于或等于 24576。
azureRead [out]: 指向 接收实际读取字节数的 DWORD 值的指针。这可能小于请求的字节数，因为某些传输会分段要传输的缓冲区，而不是使用数据填充整个缓冲区。

如果函数成功或 Win32 或 RPC 错误代码，则返回S_OK否则返回。可能的错误代码包括以下内容。