IPortableDevice::Cancel メソッド (portabledeviceapi.h)

Cancel メソッドは、このインターフェイスで保留中の操作を取り消します。

構文

HRESULT Cancel();

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
操作が正常に取り消されました。

注釈

アプリケーションが複数のスレッドから WPD API を呼び出す場合、各スレッドは IPortableDevice インターフェイスの新しいインスタンスを作成する必要があります。 これにより、取り消し操作が影響を受けるスレッドの I/O にのみ影響します。

Cancel メソッドの呼び出し時に IStream 書き込み操作が進行中の場合、アプリケーションは IStream::Revert メソッドを呼び出してすべての変更を破棄する必要があります。 変更が破棄されると、アプリケーションは IUnknown::Release メソッドを呼び出してストリームを閉じる必要もあります。

また、IStream::Write メソッドが完了する前に Cancel メソッドが呼び出されると、書き込まれるデータが破損している可能性があることに注意してください。

要件

要件
対象プラットフォーム Windows
ヘッダー portabledeviceapi.h
Library PortableDeviceGUIDs.lib

こちらもご覧ください

IPortableDevice インターフェイス