Edit

Share via

IDropTargetHelper::DragEnter method (shobjidl_core.h)

  • Article

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

Syntax

HRESULT DragEnter(
  [in] HWND        hwndTarget,
  [in] IDataObject *pDataObject,
  [in] POINT       *ppt,
  [in] DWORD       dwEffect
);

Parameters

[in] hwndTarget

Type: HWND

The target's window handle.

[in] pDataObject

Type: IDataObject*

A pointer to the data object's IDataObject interface.

[in] ppt

Type: POINT*

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

[in] dwEffect

Type: DWORD

The value pointed to by the IDropTarget::DragEnter 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::DragEnter method is called. It notifies the drag-image manager that the drop target has been entered, 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