Win32 API 日本語リファレンス
ホーム › Networking.Clustering › PCLUSTER_CLEAR_BACKUP_STATE_FOR_SHARED_VOLUME

PCLUSTER_CLEAR_BACKUP_STATE_FOR_SHARED_VOLUME

コールバック

シグネチャ

DWORD PCLUSTER_CLEAR_BACKUP_STATE_FOR_SHARED_VOLUME(
    LPWSTR lpszVolumePathName
);

パラメーター

フィールド型説明
lpszVolumePathNameLPWSTRCSV 上のファイルへのパスです。パスが CSV のパスでない場合、 ClusterClearBackupStateForSharedVolume は ERROR_INVALID_PARAMETER (87) を返します。

公式ドキュメント

クラスター共有ボリューム (CSV) のバックアップ状態をクリアします。PCLUSTER_CLEAR_BACKUP_STATE_FOR_SHARED_VOLUME 型は、この関数へのポインターを定義します。

戻り値

関数が成功した場合は、ERROR_SUCCESS (0) を返します。

関数が失敗した場合は、 システム エラー コードのいずれかを返します。

解説(Remarks)

<b>ClusterClearBackupStateForSharedVolume</b> 
関数は、クラスターのノードから呼び出す必要があります。

通常、バックアップ ジョブが完了すると、CSV の "Backup in Progress" 状態 (ClusterPrepareSharedVolumeForBackup によって設定されます) は自動的にクリアされます。つまり、CSV ボリュームはこのクラスター ノードから固定解除され、 直接 I/O が再び有効になります。 ClusterPrepareSharedVolumeForBackup の呼び出し後、スナップショットの作成処理が完了する前にバックアップ処理が終了した場合、 CSV は "Backup in Progress" 状態をクリアするまで 30 分待機します。この CSV 上で他のバックアップが 実行されていないことを要求元が安全に判断できる場合は、 ClusterClearBackupStateForSharedVolume を呼び出して CSV ボリュームの "Backup in Progress" 状態をクリアできます。

注意 特定の CSV ボリュームに対して ClusterClearBackupStateForSharedVolume 関数が呼び出されると、クラスター内のいずれかのノードで実行中の可能性がある他のバックアップに関係なく、 その CSV のバックアップ状態がクリアされます。実行中のバックアップが破損しないように、 ClusterClearBackupStateForSharedVolume を呼び出す前に、この CSV ボリュームに対して他のバックアップが実行されていないことを十分に確認してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)