IDiscFormat2RawCD::CancelWrite メソッド (imapi2.h)
現在の書き込み操作を取り消します。
構文
HRESULT CancelWrite();
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
リターン コード | 説明 |
---|---|
|
現在進行中の書き込み操作はありません。
値: 0xC0AA0601 |
|
不特定のエラー。
値: 0x80004005 |
注釈
書き込み操作を取り消すには、実装した DDiscFormat2RawCDEvents::Update イベント ハンドラーからこのメソッドを呼び出す必要があります。
このメソッドを呼び出した後、 IDiscFormat2RawCD::ReleaseMedia メソッドも呼び出す必要があります。
このメソッドを呼び出しても、メディア固有の要件により、すべてのメディアの書き込み操作が直ちに取り消されるわけではありません。 たとえば、CD に書き込む場合、書き込み操作は最大 3 分間継続できます。
このメソッドは、メディアを不確定な状態のままにします。 書き換え可能なメディアの場合は、このメソッドを呼び出した後に IDiscFormat2Erase::EraseMedia メソッドを呼び出して、メディアを将来使用できるように準備する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | imapi2.h |