IDropTargetHelper::Drop method (shobjidl_core.h)

Notifies the drag-image manager that the drop target's IDropTarget::Drop method has been called.

Syntax

HRESULT Drop(
  [in] IDataObject *pDataObject,
  [in] POINT       *ppt,
  [in] DWORD       dwEffect
);

Parameters

[in] pDataObject

Type: IDataObject*

A pointer to the data object's IDataObject interface.

[in] ppt

Type: POINT*

A POINT structure pointer that was received in the IDropTarget::Drop method's pt parameter.

[in] dwEffect

Type: DWORD

The value pointed to by the IDropTarget::Drop method's pdwEffect parameter.

Return value

Type: HRESULT

Returns S_OK if successful, or a COM error value otherwise.

Remarks

This method is called by a drop target when its IDropTarget::Drop method is called. It notifies the drag-image manager that the object has been dropped, and provides it with the information needed to display the drag image.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (version 5.0 or later)

See also

IDropTargetHelper