IDiscFormat2Data::CancelWrite メソッド (imapi2.h)

現在の書き込み操作を取り消します。

構文

HRESULT CancelWrite();

S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。次のエラーコードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。

リターンコード	説明
E_IMAPI_DF2DATA_WRITE_NOT_IN_PROGRESS	現在進行中の書き込み操作はありません。値: 0xC0AA0401
E_FAIL	不特定のエラー。値: 0x80004005

書き込み操作を取り消すには、実装した DDiscFormat2DataEvents::Update イベントハンドラーからこのメソッドを呼び出す必要があります。

このメソッドを呼び出しても、メディア固有の要件により、すべてのメディアの書き込み操作が直ちに取り消されるわけではありません。たとえば、CD に書き込む場合、書き込み操作は最大 3 分間継続できます。

このメソッドは、メディアを不確定な状態のままにします。書き換え可能なメディアの場合は、このメソッドを呼び出した後に IDiscFormat2Erase::EraseMedia メソッドを呼び出して、メディアを将来使用できるように準備する必要があります。

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	imapi2.h