IDropTargetHelper::DragEnter method (shobjidl_core.h)

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