次の方法で共有

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

  • [アーティクル]

ファイル共有スナップショットのVSS_SNAPSHOT_PROP構造を取得します。

構文

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 でのイベントとエラーの処理」を参照してください。

注釈

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

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

VSS コーディネーターは、スナップショットアクセス パス (ファイル共有スナップショットの UNC パス) を取得するために、スナップショット作成の PostSnapshot フェーズ中にこのメソッドを呼び出します。 コーディネーターは、PreFinalCommitSnapshots の後、およびライターで PostSnapshot を呼び出す前に、このメソッドを呼び出します。

要件

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

こちらもご覧ください

IVssFileShareSnapshotProvider