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

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

構文

HRESULT CancelObjectCreation(
  [in] IUnknown *pIUnknownCancelCookie
);

パラメーター

[in] pIUnknownCancelCookie

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

戻り値

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

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

解説

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

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

要件

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

関連項目

IMFSchemeHandler

スキーム ハンドラーと Byte-Stream ハンドラー