IMFSchemeHandler::CancelObjectCreation メソッド (mfidl.h)

URL からオブジェクトを作成するための現在の要求を取り消します。

構文

HRESULT CancelObjectCreation(
  [in] IUnknown *pIUnknownCancelCookie
);

[in] pIUnknownCancelCookie

IMFSchemeHandler::BeginCreateObject メソッドの ppIUnknownCancelCookie パラメーターで返された IUnknown インターフェイスへのポインター。

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

リターンコード	説明
S_OK	メソッドが成功しました。

このメソッドを使用すると、 BeginCreateObject の以前の呼び出しを取り消すことができます。ただし、そのメソッドは非同期であるため、操作を取り消す前に完了する可能性があります。そのため、このメソッドを呼び出した後もコールバックが呼び出される場合があります。

BeginCreateObject が ppIUnknownCancelCookie パラメーターで NULL を返す場合、操作を取り消すことはできません。


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mfuuid.lib