IAsyncOperation::EndOperation method

Article
04/16/2018

Notifies the data object that the asynchronous data extraction has ended.

Syntax

HRESULT EndOperation(
  [in] HRESULT  hResult,
  [in] IBindCtx *pbcReserved,
  [in] DWORD    dwEffects
);

Parameters

hResult [in]
Type: HRESULT

An HRESULT value that indicates the outcome of the data extraction. Set to S_OK if successful, or a COM error code otherwise.
pbcReserved [in]
Type: IBindCtx*

Reserved. Set to NULL.
dwEffects [in]
Type: DWORD

A DROPEFFECT value that indicates the result of an optimized move. This should be the same value that would be passed to the data object as a CFSTR_PERFORMEDDROPEFFECT format with a normal data extraction operation.

Return value

Type: HRESULT

Returns S_OK if successful or a COM error value otherwise.

Remarks

EndOperation retrieves the IAsyncOperation pointer stored by IAsyncOperation::SetAsyncMode and passes its parameter values to that interface's IAsyncOperation::EndOperation method. EndOperation then releases the IAsyncOperation pointer.

EndOperation is also responsible for any associated clean-up operations. When finished, EndOperation should notify the drop source through a private interface.

Requirements

Minimum supported client	Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (version 5.0 or later)

Share via