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

SetRestoreMetadata メソッドは、現在のコンポーネントのライター固有のメタデータを設定します。

ライターのみがこのメソッドを呼び出すことができます。また、 CSVsWriter::OnPreRestore を実装するコンテキストでのみ呼び出すことができます。

構文

HRESULT SetRestoreMetadata(
  [in] LPCWSTR wszRestoreMetadata
);

[in] wszRestoreMetadata

コンポーネントの復元メタデータを含む、呼び出し元によって割り当てられた NULL で終わるワイド文字列。

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

値	意味
S_OK	項目を正常に設定しました。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリ不足またはその他のシステムリソースです。
VSS_E_OBJECT_ALREADY_EXISTS	このコンポーネントのプライベートメタデータは既に書き込まれています。
VSS_E_BAD_STATE	このメソッドは、 PreRestore イベントを処理するライターのコンテキストの外部で呼び出されました。

IVssComponent::SetRestoreMetadata は、ライター固有のプライベートメタデータを設定します。これは、復元操作中にライターが使用できます。

この形式は、VSS メタデータの仕様に準拠している必要はありません。

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