IVssBackupComponents::EnableWriterClasses メソッド (vsbackup.h)
EnableWriterClasses メソッドを使用すると、指定したライターがすべてのイベントを受信できます。
構文
HRESULT EnableWriterClasses(
[in] const VSS_ID *rgWriterClassId,
[in] UINT cClassId
);
パラメーター
[in] rgWriterClassId
1 つ以上のライター クラス識別子を含む配列。
[in] cClassId
rgWriterClassId 配列内のエントリの数。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
ライター クラスが正常に有効になりました。 |
|
呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 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 |