IVssDifferentialSoftwareSnapshotMgmt::QueryDiffAreasOnVolume メソッド (vsmgmt.h)

  • [アーティクル]

QueryDiffAreasOnVolume メソッドは、指定されたボリューム上に物理的に存在するシャドウ コピーストレージ領域に対してクエリを実行します。

構文

HRESULT QueryDiffAreasOnVolume(
  [in]  VSS_PWSZ           pwszVolumeName,
  [out] IVssEnumMgmtObject **ppEnum
);

パラメーター

[in] pwszVolumeName

シャドウ コピー記憶域を含むボリュームの名前。

ボリュームの名前は、次のいずれかの形式である必要があり、末尾に円記号 (\) を含める必要があります。

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

[out] ppEnum

返されるときに初期化される IVssEnumMgmtObject インターフェイス ポインターのアドレス。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 意味
S_OK
 シャドウ コピーの記憶域に対してクエリが正常に実行されました。
E_ACCESSDENIED
 呼び出し元に十分なバックアップ特権がないか、管理者ではありません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
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 が使用されます。

注釈

返された IVssEnumMgmtObject 列挙子オブジェクトには、VSS_MGMT_OBJECT_PROP構造体内のVSS_MGMT_OBJECT_UNION共用体内のVSS_DIFF_AREA_PROP構造体が含まれます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vsmgmt.h

こちらもご覧ください

IVssDifferentialSoftwareSnapshotMgmt

IVssEnumMgmtObject