IMFSchemeHandler::CancelObjectCreation method (mfidl.h)

Article
02/22/2024

Cancels the current request to create an object from a URL.

Syntax

HRESULT CancelObjectCreation(
  [in] IUnknown *pIUnknownCancelCookie
);

Parameters

[in] pIUnknownCancelCookie

Pointer to the IUnknown interface that was returned in the ppIUnknownCancelCookie parameter of the IMFSchemeHandler::BeginCreateObject method.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.

Remarks

You can use this method to cancel a previous call to BeginCreateObject. Because that method is asynchronous, however, it might be completed before the operation can be canceled. Therefore, your callback might still be invoked after you call this method.

The operation cannot be canceled if BeginCreateObject returns NULL in the ppIUnknownCancelCookie parameter.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mfidl.h
Library	Mfuuid.lib