ClusterPrepareSharedVolumeForBackup 函数 (resapi.h)

[ClusterPrepareSharedVolumeForBackup 可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]

不需要调用此函数。 函数除了检索卷路径和卷名称外,不会执行任何其他操作。

Windows Server 2008 R2: 准备群集共享卷 (CSV) 进行备份。 这会在本地装载 CSV,将其固定到此群集节点,禁用直接 I/O,并将卷状态设置为“正在进行备份”。

语法

DWORD ClusterPrepareSharedVolumeForBackup(
  [in]      LPCWSTR lpszFileName,
  [out]     LPWSTR  lpszVolumePathName,
  [in, out] LPDWORD lpcchVolumePathName,
  [out]     LPWSTR  lpszVolumeName,
  [in, out] LPDWORD lpcchVolumeName
);

parameters

[in] lpszFileName

群集共享卷上的目录或文件的路径。

[out] lpszVolumePathName

将接收 CSV 重新分析点的缓冲区的地址。

[in, out] lpcchVolumePathName

输入上的 DWORD 的地址包含缓冲区 (的大小(以 WCHAR 字符为单位)) lpszVolumePathName 参数指向,输出时包含写入该缓冲区的字符串的大小。 如果输入的大小不够大,则该函数将失败并返回 ERROR_MORE_DATA 并将 DWORD 设置为所需的大小。

[out] lpszVolumeName

将接收 CSV 的卷 GUID 路径的缓冲区的地址。

[in, out] lpcchVolumeName

输入上的 DWORD 的地址包含缓冲区 (的大小(以 WCHAR 字符为单位)) lpszVolumeName 参数指向,输出时包含写入该缓冲区的字符串的大小。 如果输入的大小不够大,则该函数将失败并返回 ERROR_MORE_DATA 并将 DWORD 设置为所需的大小。

返回值

如果函数成功,则返回 ERROR_SUCCESS

如果函数失败,它将返回 系统错误代码之一。

注解

必须从群集的节点调用 ClusterPrepareSharedVolumeForBackup 函数。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 R2 Enterprise、Windows Server 2008 R2 Datacenter
目标平台 Windows
标头 resapi.h
Library ResUtils.Lib
DLL ResUtils.Dll

请参阅

使用 VSS 备份和还原故障转移群集配置

备份和还原功能