次の方法で共有

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

  • [アーティクル]

指定したシャドウ コピーのプロパティを取得します。

構文

HRESULT GetSnapshotProperties(
  [in]  VSS_ID            SnapshotId,
  [out] VSS_SNAPSHOT_PROP *pProp
);

パラメーター

[in] SnapshotId

シャドウ コピー識別子。

[out] pProp

シャドウ コピー プロパティを受け取る呼び出し元によって割り当てられた VSS_SNAPSHOT_PROP 構造体のアドレス。 プロバイダーは、この構造体のメンバーを設定する役割を担います。 プロバイダーが NULL に設定できるm_pwszExposedNameとm_pwszExposedPathを除き、すべてのメンバーが必要です。 プロバイダーは、構造体に設定するすべての文字列メンバーにメモリを割り当てます。 構造体が不要になった場合、呼び出し元は VssFreeSnapshotProperties 関数を呼び出すことによって、これらの文字列を解放する必要があります。

戻り値

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

値 意味
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が使用されます。

注釈

呼び出し元は、GetSnapshotProperties メソッドを呼び出す前に、VSS_SNAPSHOT_PROP構造体の内容を 0 に設定する必要があります。

プロバイダーは、 VSS_SNAPSHOT_PROP 構造体内の文字列の割り当てと解放を担当します。

要件

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

こちらもご覧ください

IVssSoftwareSnapshotProvider

VssFreeSnapshotProperties