IVssWMFiledesc::GetAlternateLocation メソッド (vswriter.h)

GetAlternateLocation メソッドは、ファイル セットの別の場所を取得します。

構文

HRESULT GetAlternateLocation(
  [out] BSTR *pbstrAlternateLocation
);

パラメーター

[out] pbstrAlternateLocation

代替バックアップの場所を指定する文字列を受け取る呼び出し元によって割り当てられた変数のアドレス。 この場所のパスには、ローカル パスまたはリモート ファイル共有の UNC パスを指定できます。 別の場所がない場合、ポインターは NULL です。

戻り値

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

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

解説

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP、Windows Server 2003: リモート ファイル共有は、Windows 8 および Windows Server 2012 まではサポートされません。

呼び出し元は、pbstrAlternateLocation パラメーターによって保持されているメモリを解放するために SysFreeString を呼び出す必要があります。

GetAlternateLocation によって返される代替の場所の解釈は、IVssWMFiledesc オブジェクトの取得に使用されるメソッドによって異なります。

• IVssExamineWriterMetadata::GetExcludeFile
• IVssWMComponent::GetDatabaseFile
• IVssWMComponent::GetDatabaseLogFile
• IVssWMComponent::GetFile

GetAlternateLocation によって返される値は、IVssExamineWriterMetadata::GetAlternateLocationMapping メソッドによって返される代替の場所マッピングを参照します。

バックアップ操作中に、これはファイルをバックアップする別の場所です。 復元中は、ファイルを復元する別の場所です。

詳細については、「 既定以外のバックアップと復元の場所」を参照してください。

要件

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

関連項目

IVssWMFiledesc