IVssBackupComponents::ExposeSnapshot メソッド (vsbackup.h)
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 は、この文字列のメモリを割り当てます。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
シャドウ コピーが正常に公開されました。 |
|
呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。 |
|
パラメーター値の 1 つが無効です。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。 |
|
指定されたシャドウ コピーが存在しません。 |
|
プロバイダー エラーが予想されます。 プロバイダーがイベント ログにエラーを記録しました。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。 |
|
予期しないプロバイダー エラー。 エラー コードはエラー ログに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 |
注釈
呼び出し元は、CoTaskMemFree 関数を呼び出すことによって、pwszExposed パラメーターが指す文字列を解放します。
永続的なシャドウ コピーを公開する場合は、後続のブートを通じて公開されたままになります。
ボリュームのシャドウ コピーを公開する場合、シャドウ コピーはマウント可能なデバイスとして、またはファイル共有に使用できるファイル システムとして扱われる場合があります。
他のマウント可能なデバイスと同様にデバイスとして公開される場合、ボリュームのシャドウ コピーは、そのルートから始まるマウント ポイント (ドライブ文字またはマウントされたフォルダー) で公開されます。
ファイル共有として公開されている場合、ボリュームのサブセット ( wszPathFromRoot によって示されます) を共有できます。
シャドウ コピーを公開する方法の詳細については、「シャドウ コピー されたボリュームの公開と表示」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |
こちらもご覧ください
IVssBackupComponents::ImportSnapshots