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
);
參數
[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 |
| 程式庫 | ResUtils.Lib |
| Dll | ResUtils.Dll |