IVssBackupComponents::EnableWriterClasses メソッド (vsbackup.h)

  • [アーティクル]

EnableWriterClasses メソッドを使用すると、指定したライターがすべてのイベントを受信できます。

構文

HRESULT EnableWriterClasses(
  [in] const VSS_ID *rgWriterClassId,
  [in] UINT         cClassId
);

パラメーター

[in] rgWriterClassId

1 つ以上のライター クラス識別子を含む配列。

[in] cClassId

rgWriterClassId 配列内のエントリの数。

戻り値

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

値 意味
S_OK
 ライター クラスが正常に有効になりました。
E_ACCESSDENIED
 呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_BAD_STATE
 バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

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

注釈

EnableWriterClasses メソッドと IVssBackupComponents::D isableWriterClasses メソッドが呼び出されない場合、すべてのライター クラスが有効になります。

EnableWriterClasses の最初の呼び出しが返されると、rgWriterClassId 配列で指定されたライター クラスが有効になり、他のすべてのライター クラスが無効になります。

EnableWriterClasses を複数回呼び出すと、各呼び出しで rgWriterClassId 配列内のライターが有効なライターの一覧に追加されます。

EnableWriterClasses を 1 回以上呼び出してから DisableWriterClasses を呼び出すと、DisableWriterClasses の呼び出しによって、EnableWriterClasses の呼び出しで有効にされた rgWriterClassId 配列内のライターはすべて無効になります。

EnableWriterClasses を呼び出す場合は、IVssBackupComponents::GatherWriterMetadata メソッドを呼び出す前に行う必要があります。 GatherWriterMetadata を最初に呼び出してから EnableWriterClasses を呼び出した場合、EnableWriterClasses の呼び出しは無効になります。 GatherWriterMetadata を最初に呼び出して、有効にするライター クラスを決定する必要がある場合は、IVssBackupComponents インターフェイスの別のインスタンスから呼び出す必要があります。

要件

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

こちらもご覧ください

IVssBackupComponents

IVssBackupComponents::D isableWriterClasses

IVssBackupComponents::D isableWriterInstances