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否则返回。 可能的错误代码包括以下内容。
-
ERROR_INVALID_PARAMETER
-
一个或多个参数无效。
-
ERROR_HANDLE_EOF
-
已到达备份文件的末尾。
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista |
最低受支持的服务器 |
Windows Server 2008 |
标头 |
|
库 |
|
DLL |
|