IVssExamineWriterMetadata::GetAlternateLocationMapping メソッド (vsbackup.h)

GetAlternateLocationMapping メソッドは、ファイルセットの特定の代替場所マッピングを取得します。

構文

HRESULT GetAlternateLocationMapping(
  [in]  UINT           iMapping,
  [out] IVssWMFiledesc **ppFiledesc
);

[in] iMapping

特定のマッピングのインデックス。このパラメーターの値は、0 から n から 1 までの整数です。 n は、特定のライターに関連付けられた代替ロケーションマッピングの合計数です。 n の値は、IVssExamineWriterMetadata::GetRestoreMethod によって返されます。

[out] ppFiledesc

代替ロケーションマッピング情報を含む IVssWMFiledesc オブジェクトへの二重間接ポインター。

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

値	説明
S_OK	IVssWMFiledesc インターフェイスへのポインターが正常に返されました。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリやその他のシステムリソースを使い切れている。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細については、イベントログを確認してください。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_OBJECT_NOT_FOUND	指定された代替場所マッピングが存在しません。
VSS_E_UNEXPECTED	予期しないエラー。エラーコードは、エラーログファイルに記録されます。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。代わりに E_UNEXPECTED が使用されます。

IVssExamineWriterMetadata::GetAlternateLocationMapping によって返される値は、IVssComponent::GetAlternateLocationMapping によって返される値と混同しないでください。

IVssComponent::GetAlternateLocationMapping は、ファイルが復元された別の場所です。

IVssExamineWriterMetadata::GetAlternateLocationMapping は、必要に応じてファイルを復元できる別の場所マッピングです。

次のいずれかが当てはまる場合は、常にファイルを別の場所マッピングに復元する必要があります。

いずれの場合も、有効な代替ロケーション・マッピングが定義されていない場合、これはライター・エラーを構成します。

次のいずれかが当てはまる場合は、ファイルを別の場所マッピングに復元できます。

ここでも、有効な代替場所マッピングが定義されていない場合、これはライターエラーを構成します。

代替の場所マッピングは復元操作中にのみ使用され、バックアップ操作中にのみ使用される代替パスと混同しないでください。

呼び出し元は、 IUnknown::Release を呼び出して、返された IVssWMFiledesc オブジェクトのリソースを解放します。


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