IVssCreateWriterMetadata::AddDatabaseLogFiles メソッド (vswriter.h)

  • [アーティクル]

AddDatabaseLogFiles メソッドは、バックアップするデータベースに関連付けられているログ ファイルとその場所を示します。

構文

HRESULT AddDatabaseLogFiles(
  [in] LPCWSTR wszLogicalPath,
  [in] LPCWSTR wszDatabaseName,
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] DWORD   dwBackupTypeMask
);

パラメーター

[in] wszLogicalPath

ログ ファイルが追加されるデータベース コンポーネントの論理パスを含む 、null で終わるワイド文字列へのポインター。

詳細については、「 コンポーネントの論理パス」を参照してください。

論理パスは必須ではなく、 NULL にすることができます。

[in] wszDatabaseName

ログ ファイルに関連付けられているデータベース コンポーネントの名前を含む null で終わるワイド文字列へのポインター。 このコンポーネントの型はVSS_CT_DATABASEする必要があります。それ以外の場合、メソッドはエラーを返します。

[in] wszPath

ログ ファイルを含むディレクトリのパスを含む null で終わるワイド文字列へのポインター。

ディレクトリは VSS マシン上のローカル ディレクトリにすることも、リモート ファイル サーバー上のファイル共有ディレクトリにすることもできます。

UNC パスがサポートされています。

パスには環境変数 (%SystemRoot%) を含めることができますが、ワイルドカード文字を含めることはできません。

パスが円記号 ("") で終わるという要件はありません。 この情報を取得するのはアプリケーションによってチェック。

[in] wszFilespec

データベースに関連付けられているログ ファイルのファイル指定を含む null で終わるワイド文字列へのポインター。

ファイル指定にディレクトリ指定を含めることはできません (たとえば、バックスラッシュは含めません)、 を含めることができます。 および * ワイルドカード文字。

[in] dwBackupTypeMask

ライターが特定の種類のバックアップ操作に参加するためにファイルを評価する必要があるかどうかを示す、 VSS_FILE_SPEC_BACKUP_TYPE 列挙値のビット マスク (またはビットごとの OR)。

この引数の既定値は (VSS_FSBT_ALL_BACKUP_REQUIRED |VSS_FSBT_ALL_SNAPSHOT_REQUIRED)。

戻り値

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

値 説明
S_OK
 操作に成功しました。
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 が使用されます。

解説

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP、Windows Server 2003: リモート ファイル共有は、Windows 8 と Windows Server 2012 まではサポートされません。 ライターはローカル リソースのみをサポートします。絶対パスが有効なローカル ボリューム仕様で始まり、マップされたネットワーク ドライブにすることはできません。 したがって、(環境変数の解決後に) AddDatabaseLogFiles へのパス入力 (wszPath) は、この形式である必要があります。

このメソッドは、特定のデータベース コンポーネントに対して複数回呼び出すことができます。これは、複数のログ ファイルが別々のボリュームに格納されている場合に必要になる場合があります。

wszLogicalPath パラメーターと wszDatabaseName パラメーターの値は、以前に IVssCreateWriterMetadata::AddComponent メソッドで追加されたデータベース コンポーネントのいずれかと一致する必要があります。

要件

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

関連項目

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent