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

指定したボリュームにシャドウコピーが存在するかどうかを判断します。

構文

HRESULT IsVolumeSnapshotted(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSnapshotsPresent,
  [out] LONG     *plSnapshotCompatibility
);

[in] pwszVolumeName

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

[out] pbSnapshotsPresent

ボリュームにシャドウコピーがある場合は TRUE 、ボリュームにシャドウコピーがない場合は FALSE を 受け取ります。

[out] plSnapshotCompatibility

ボリュームにシャドウコピーがある場合、特定のボリューム制御操作またはファイル I/O 操作が特定のボリュームに対して無効になっているかどうかを示すVSS_SNAPSHOT_COMPATIBILITY値のビットマスク。

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

値	意味
S_OK	要求された情報が正常に返されました。
E_ACCESSDENIED	呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG	パラメーター値の 1 つが無効です。
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 が使用されます。

選択したボリュームに対してボリューム制御操作またはファイル I/O 操作が無効にされていない場合、 plSnapshotCapability によって返される選択されたボリュームのシャドウコピー機能は 0 になります。