IDataObjectAsyncCapability::SetAsyncMode method (shldisp.h)
Called by a drop source to specify whether the data object supports asynchronous data extraction.
Syntax
HRESULT SetAsyncMode(
[in] BOOL fDoOpAsync
);
Parameters
[in] fDoOpAsync
Type: BOOL
VARIANT_TRUE if an asynchronous operation is supported; otherwise, VARIANT_FALSE. The default value is VARIANT_FALSE.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
This method is called by the drop source to indicate that the data object supports asynchronous data extraction. Store the fDoOpAsync for later use by IDataObjectAsyncCapability::GetAsyncMode. The drop target determines whether asynchronous data extraction is supported by calling IDataObjectAsyncCapability::GetAsyncMode to retrieve the fDoOpAsync value.
If fDoOpAsync is set to VARIANT_TRUE, SetAsyncMode must call IDataObjectAsyncCapability::AddRef, and store the interface pointer for use by IDataObjectAsyncCapability::EndOperation.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8 [desktop apps only] |
Minimum supported server | Windows Server 2012 [desktop apps only] |
Target Platform | Windows |
Header | shldisp.h |
DLL | Shell32.dll (version 6.0 or later) |