IVssBackupComponents::ExposeSnapshot メソッド (vsbackup.h)

[アーティクル]
08/27/2023

ExposeSnapshot メソッドは、シャドウコピーをドライブ文字、マウントされたフォルダー、またはファイル共有として公開します。

構文

HRESULT ExposeSnapshot(
  [in]  VSS_ID   SnapshotId,
  [in]  VSS_PWSZ wszPathFromRoot,
  [in]  LONG     lAttributes,
  [in]  VSS_PWSZ wszExpose,
  [out] VSS_PWSZ *pwszExposed
);

パラメーター

[in] SnapshotId

シャドウコピー識別子。

[in] wszPathFromRoot

シャドウコピーをファイル共有として公開するときに使用できるボリュームの部分へのパス。シャドウコピーをローカルで公開する場合、このパラメーターの値は NULL である必要があります。つまり、ドライブ文字またはマウントされたフォルダーとして公開されます。

パスに環境変数 (%MyEnv%) やワイルドカード文字を含めることはできません。

パスが円記号 ("") で終わるという要件はありません。この情報を取得するのはアプリケーションによってチェック。

[in] lAttributes

ローカルまたはリモートで公開されているかどうかを示す、公開されたシャドウコピーの属性。値は、VSS_VOLSNAP_ATTR_EXPOSED_LOCALLYまたは _VSS_VOLUME_SNAPSHOT_ATTRIBUTES のVSS_VOLSNAP_ATTR_EXPOSED_REMOTELY値である必要があります。

[in] wszExpose

シャドウコピーがファイル共有として公開される場合、このパラメーターの値は共有名です。シャドウコピーをデバイスとしてマウントして公開する場合、パラメーター値はドライブ文字の後にコロン ("X:" やマウントされたフォルダーパス ("Y:\MountX" など) が続きます。このパラメーターの値が NULL の場合、 lAttributes パラメーターが VSS_VOLSNAP_ATTR_EXPOSED_REMOTELYされている場合、VSS は共有名またはドライブ文字を決定します。

[out] pwszExposed

シャドウコピーの公開された名前。これは、共有名、ドライブ文字の後にコロン、またはマウントされたフォルダーのいずれかです。 ExposeSnapshot が失敗した場合、値は NULL です。 VSS は、この文字列のメモリを割り当てます。

戻り値

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

値	意味
S_OK	シャドウコピーが正常に公開されました。
E_ACCESSDENIED	呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリやその他のシステムリソースを使い切れている。
VSS_E_BAD_STATE	バックアップコンポーネントオブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。
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 が使用されます。
VSS_E_UNEXPECTED_PROVIDER_ERROR	予期しないプロバイダーエラー。エラーコードはエラーログに記録されます。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

注釈

呼び出し元は、CoTaskMemFree 関数を呼び出すことによって、pwszExposed パラメーターが指す文字列を解放します。

永続的なシャドウコピーを公開する場合は、後続のブートを通じて公開されたままになります。

ボリュームのシャドウコピーを公開する場合、シャドウコピーはマウント可能なデバイスとして、またはファイル共有に使用できるファイルシステムとして扱われる場合があります。

他のマウント可能なデバイスと同様にデバイスとして公開される場合、ボリュームのシャドウコピーは、そのルートから始まるマウントポイント (ドライブ文字またはマウントされたフォルダー) で公開されます。

ファイル共有として公開されている場合、ボリュームのサブセット ( wszPathFromRoot によって示されます) を共有できます。

シャドウコピーを公開する方法の詳細については、「シャドウコピーされたボリュームの公開と表示」を参照してください。

要件

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