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
入力時に lpszVolumePathName パラメーターが指すバッファーのサイズ (WCHAR 文字) を含む DWORD のアドレス。出力には、そのバッファーに書き込まれた文字列のサイズが含まれます。 入力のサイズが十分な大きさでない場合、関数は失敗し 、ERROR_MORE_DATA を返し、 DWORD を必要なサイズに設定します。
[out] lpszVolumeName
CSV のボリューム GUID パスを受け取るバッファーのアドレス。
[in, out] lpcchVolumeName
入力時に lpszVolumeName パラメーターが指すバッファーのサイズ (WCHAR 文字) を含む DWORD のアドレス。出力には、そのバッファーに書き込まれた文字列のサイズが含まれます。 入力のサイズが十分な大きさでない場合、関数は失敗し 、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 |