IVssComponent::GetPreviousBackupStamp メソッド (vswriter.h)

  • [アーティクル]

GetPreviousBackupStamp メソッドは、バックアップ コンポーネント ドキュメントで要求者によって読み込まれた以前のバックアップ スタンプを返します。 値は、ファイルを差分バックアップ操作または増分バックアップ操作に参加させる必要があるかどうかを決定するときに、ライターによって使用されます。

ライターまたはリクエスターは、このメソッドを呼び出すことができます。

構文

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

パラメーター

[out] pbstrBackupStamp

差分バックアップまたは増分バックアップを正しく実装できるように、以前のバックアップのタイム スタンプを含む文字列へのポインター。

戻り値

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

値 意味
S_OK
 属性値が正常に返されました。
S_FALSE
 以前のバックアップ タイムスタンプが設定されていません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_INVALID_XML_DOCUMENT
 XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

注釈

バックアップ スタンプの詳細については、「 複雑なストアのバックアップにおけるライター ロール」および「複合ストア の バックアップ」の「リクエスター ロール」を参照してください。

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

以前のバックアップ タイム スタンプがない場合、 GetPreviousBackupStamp はS_FALSEを返します。

返される文字列は、コンポーネント内のすべてのファイルと、コンポーネントが持つ選択できないサブコンポーネントを参照します。

GetPreviousBackupStamp によって取得されたバックアップ スタンプは、IVssBackupComponents::SetPreviousBackupStamp を使用してリクエスターによって設定されます。

通常、 GetPreviousBackupStamp によって検出された値の設定に使用される文字列は、格納されているバックアップ コンポーネント ドキュメントから取得されたか、要求元によって独自の内部レコードの一部として格納されていました。

要件

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

こちらもご覧ください

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent