IVssBackupComponents::D isableWriterInstances メソッド (vsbackup.h)
DisableWriterInstances メソッドは、指定されたライター インスタンスまたはインスタンスを無効にします。
構文
HRESULT DisableWriterInstances(
[in] const VSS_ID *rgWriterInstanceId,
[in] UINT cInstanceId
);
パラメーター
[in] rgWriterInstanceId
1 つ以上のライター インスタンス識別子を含む配列。
[in] cInstanceId
rgWriterInstanceId 配列内のエントリの数。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
ライター クラスが正常に有効になりました。 |
|
呼び出し元に十分なバックアップ特権がないか、管理者ではありません。 |
|
呼び出し元がメモリ不足またはその他のシステム リソースです。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。 |
|
予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。 |
注釈
同じライターの複数の実行中のコピーがある場合、それらはすべて同じライター クラス識別子を持っていますが、ライター インスタンス識別子は異なります。 ライターの 1 つのインスタンスを無効にしても、ライターの他のインスタンスは無効になりません。
DisableWriterInstances を呼び出す場合は、IVssBackupComponents::GatherWriterMetadata メソッドを呼び出す前に実行する必要があります。 GatherWriterMetadata を最初に呼び出してから DisableWriterInstances を呼び出した場合、DisableWriterInstances の呼び出しは無効になります。 最初に GatherWriterMetadata を呼び出して無効にするライター インスタンスを決定する必要がある場合は、IVssBackupComponents インターフェイスの別のインスタンスから呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |
こちらもご覧ください
IVssBackupComponents::D isableWriterClasses