ホーム › Networking.Clustering › PCLUSTER_PREPARE_SHARED_VOLUME_FOR_BACKUP

PCLUSTER_PREPARE_SHARED_VOLUME_FOR_BACKUP

コールバック

シグネチャ

DWORD PCLUSTER_PREPARE_SHARED_VOLUME_FOR_BACKUP(
    LPWSTR lpszFileName,
    LPWSTR lpszVolumePathName,
    DWORD* lpcchVolumePathName,
    LPWSTR lpszVolumeName,
    DWORD* lpcchVolumeName
);

パラメーター

フィールド	型	説明
lpszFileName	LPWSTR	クラスター共有ボリューム上のディレクトリまたはファイルへのパスです。
lpszVolumePathName	LPWSTR	CSV の再解析ポイントを受け取るバッファーのアドレスです。
lpcchVolumePathName	DWORD*	DWORD のアドレスです。入力時には lpszVolumePathName パラメーターが指すバッファーのサイズ( WCHAR 文字単位)を格納し、出力時にはそのバッファーに書き込まれた文字列のサイズを格納します。入力時のサイズが十分でない場合、この関数は失敗して ERROR_MORE_DATA を返し、 DWORD に必要なサイズを設定します。
lpszVolumeName	LPWSTR	CSV のボリューム GUID パスを受け取るバッファーのアドレスです。
lpcchVolumeName	DWORD*	DWORD のアドレスです。入力時には lpszVolumeName パラメーターが指すバッファーのサイズ( WCHAR 文字単位)を格納し、出力時にはそのバッファーに書き込まれた文字列のサイズを格納します。入力時のサイズが十分でない場合、この関数は失敗して ERROR_MORE_DATA を返し、 DWORD に必要なサイズを設定します。

公式ドキュメント

[ClusterPrepareSharedVolumeForBackup は、「要件」セクションに記載されたオペレーティングシステムで使用できます。以降のバージョンでは変更されるか、利用できなくなる可能性があります。]

この関数を呼び出す必要はありません。この関数は、ボリュームパスとボリューム名を取得する以外には何も行いません。

Windows Server 2008 R2: クラスター共有ボリューム (CSV) をバックアップ用に準備します。これにより、CSV をローカルにマウントし、このクラスターノードに固定し、直接 I/O を無効にして、ボリュームの状態を "Backup in Progress" に設定します。

戻り値

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

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

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)