IVssSoftwareSnapshotProvider::IsVolumeSupported メソッド (vsprov.h)

プロバイダーが、指定したボリューム上のシャドウコピーをサポートするかどうかを決定します。

構文

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

[in] pwszVolumeName

ボリューム名を含む Null で終わるワイド文字列。名前は次のいずれかの形式にする必要があり、末尾に円記号 (\) を含める必要があります。

[out] pbSupportedByThisProvider

指定したボリュームでシャドウコピーがサポートされている場合、このパラメーターは TRUE を 受け取り、それ以外の場合 は FALSE を受け取ります。

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

値	説明
S_OK	要求された情報が正常に返されました。
E_ACCESSDENIED	呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG	パラメーター値の 1 つが無効です。
VSS_E_NESTED_VOLUME_LIMIT	指定されたボリュームが深すぎて VSS 操作に参加できません。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: このリターンコードはサポートされていません。
E_OUTOFMEMORY	呼び出し元がメモリやその他のシステムリソースを使い切れている。
VSS_E_OBJECT_NOT_FOUND	指定されたボリュームが見つかりませんでした。
VSS_E_PROVIDER_VETO	プロバイダーエラー。プロバイダーがイベントログにエラーを記録しました。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_UNEXPECTED	予期しないエラー。エラーコードは、エラーログファイルに記録されます。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。代わりに E_UNEXPECTED が使用されます。

IsVolumeSupported メソッドは、現在の構成で現在のボリュームでシャドウコピーの作成が許可されていない場合でも、特定のボリュームにシャドウコピーを作成できる場合は TRUE を返します。

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

別の VHD 内に入れ子になっている仮想ハードディスク (VHD) に対しては、このメソッドを呼び出すことはできません。

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