IDiscFormat2TrackAtOnce::CancelAddTrack メソッド (imapi2.h)
現在の書き込み操作を取り消します。
構文
HRESULT CancelAddTrack();
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
| リターン コード | 説明 |
|---|---|
|
現在進行中の書き込み操作はありません。
値: 0xC0AA0501 |
|
不特定のエラー。
値: 0x80004005 |
注釈
書き込み操作を取り消すには、実装した DDiscFormat2TrackAtOnceEvents::Update イベント ハンドラーからこのメソッドを呼び出す必要があります。
このメソッドを呼び出した後、 IDiscFormat2TrackAtOnce::ReleaseMedia メソッドも呼び出す必要があります。
このメソッドを呼び出しても、メディア固有の要件により、すべてのメディアの書き込み操作が直ちに取り消されるわけではありません。 たとえば、CD に書き込む場合、書き込み操作は最大 3 分間続行できます。
この方法では、部分的なオーディオ トラックが既に記録されている可能性があります。 メソッドはメディアを使用可能な状態に保つよう試み、取り消されたトラックを IStream で最初に記述されたよりも短いと扱います。 呼び出し元は、取り消した後にトラック数とトラック サイズに対してクエリを実行して、ディスクの状態を判断する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi2.h |