次の方法で共有


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