CreateVssExamineWriterMetadata 関数 (vsbackup.h)

  • [アーティクル]

CreateVssExamineWriterMetadata 関数は、IVssExamineWriterMetadata オブジェクトを作成します。

メモ この関数は CreateVssExamineWriterMetadataInternal としてエクスポートされますが、 CreateVssExamineWriterMetadataInternal ではなく CreateVssExamineWriterMetadata を呼び出す必要があります。

 

構文

HRESULT CreateVssExamineWriterMetadata(
  [in]  BSTR                      bstrXML,
  [out] IVssExamineWriterMetadata **ppMetadata
);

パラメーター

[in] bstrXML

返された IVssExamineWriterMetadata オブジェクトを初期化するための Writer メタデータ ドキュメントを含む XML 文字列。

[out] ppMetadata

オブジェクトへの IVssExamineWriterMetadata インターフェイス ポインターを受け取る変数。

戻り値

ここで示す戻り値は、関数からいつでも返される通常の COM HRESULT に加えてあります。

値 説明
S_OK
 IVssExamineWriterMetadata インターフェイスへのポインターが正常に返されました。
E_ACCESSDENIED
 呼び出し元に十分なバックアップ特権がないか、管理者ではありません。
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_OUTOFMEMORY
 メモリ不足またはその他のシステム リソース。
VSS_E_INVALID_XML_DOCUMENT
 bstrXML パラメーターで渡された XML ドキュメントが無効です。つまり、正しい形式の XML 文字列ではないか、スキーマと一致しません。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。

解説

ライターのライター メタデータ ドキュメントのコピーを XML 文字列に保存して bstrXML パラメーターを渡すには、 IVssExamineWriterMetadata::SaveAsXML メソッドを 使用します。

ライターのライター メタデータ ドキュメントの最新バージョンを取得するには、 IVssBackupComponents::GetWriterMetadata メソッドを使用します。

ライター メタデータ ドキュメントを既存の IVssExamineWriterMetadata オブジェクトに読み込むには、 IVssExamineWriterMetadata::LoadFromXML メソッドを使用します。

ユーザーは、ライター メタデータ ドキュメントの内容を変更しないでください。

呼び出し元のアプリケーションは、 IUnknown::Release を呼び出して、オブジェクトが不要になったときに IVssExamineWriterMetadata オブジェクトが保持するリソースを解放する役割を担います。

要件

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

関連項目

IVssExamineWriterMetadata