IVssBackupComponents::IsVolumeSupported メソッド (vsbackup.h)

  • [アーティクル]

IsVolumeSupported メソッドは、指定されたプロバイダーが、指定したボリュームまたはリモート ファイル共有のシャドウ コピーをサポートするかどうかを決定します。

構文

HRESULT IsVolumeSupported(
  [in]  VSS_ID   ProviderId,
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSupportedByThisProvider
);

パラメーター

[in] ProviderId

プロバイダー識別子。 値がGUID_NULL場合、 IsVolumeSupported は、どのプロバイダーでもボリュームまたはリモート ファイル共有をサポートしているかどうかを確認します。

[in] pwszVolumeName

リモート ファイル共有のボリューム名または UNC パス。 名前または UNC パスは、次のいずれかの形式で、末尾の円記号 (\) を含める必要があります。

  • マウントされたフォルダーのパス (Y:\MountX\ など)
  • ドライブ文字 (D:\ など)
  • \\?\Volume{GUID}\ という形式のボリューム GUID パス ( GUID はボリュームを識別します)
  • リモート ファイル共有を指定する UNC パス (\\Clusterx\Share1\ など)

[out] pbSupportedByThisProvider

指定したボリュームまたはリモート ファイル共有でシャドウ コピーがサポートされている場合は TRUE、 それ以外の場合は FALSE を受け取る呼び出し元によって割り当てられた変数のアドレス。

戻り値

このメソッドの有効なリターン コードを次に示します。

値 意味
S_OK
 プロバイダーのサポート情報が正常に返されました。
E_ACCESSDENIED
 呼び出し元に十分なバックアップ特権がないか、管理者ではありません。
VSS_E_NESTED_VOLUME_LIMIT
 指定されたボリュームが入れ子になっているので、VSS 操作に参加できません。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: このリターン コードはサポートされていません。
E_OUTOFMEMORY
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_BAD_STATE
 バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。
VSS_E_OBJECT_NOT_FOUND
 指定されたボリュームまたはリモート ファイル共有が見つからないか、使用できませんでした。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。

注釈

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP、Windows Server 2003: リモート ファイル共有は、Windows 8してWindows Server 2012するまでサポートされません。

IsVolumeSupported は、現在の構成でそのボリュームにシャドウ コピーを作成できない場合でも、特定のボリュームにシャドウ コピーを作成できる場合は TRUE を返します。

たとえば、特定のボリュームでシャドウ コピーの最大数に達した場合 (そのため、そのボリュームにシャドウ コピーを作成できない場合)、メソッドはボリュームをシャドウ コピーできることを示します。

メモボリュームに作成できるシャドウ コピーの最大数の詳細については、「レジストリ キーとバックアップと復元の値」の MaxShadowCopies のエントリを参照してください。
 
このメソッドは、別の VHD 内に入れ子になっている仮想ハード ディスク (VHD) に対して呼び出すことはできません。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: VHD はサポートされていません。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む)
Library VssApi.lib

こちらもご覧ください

IVssBackupComponents

IVssBackupComponents::AddToSnapshotSet