IVssBackupComponents::D isableWriterInstances メソッド (vsbackup.h)

DisableWriterInstances メソッドは、指定されたライターインスタンスまたはインスタンスを無効にします。

構文

HRESULT DisableWriterInstances(
  [in] const VSS_ID *rgWriterInstanceId,
  [in] UINT         cInstanceId
);

パラメーター

[in] rgWriterInstanceId

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

[in] cInstanceId

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

戻り値

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

値	意味
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が使用されます。

注釈

同じライターの複数の実行中のコピーがある場合、それらはすべて同じライタークラス識別子を持っていますが、ライターインスタンス識別子は異なります。ライターの 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