LPFNDFMCALLBACK function pointer
[LPFNDFMCALLBACK is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
Defines the prototype for the callback function that receives messages from the Shell's default context menu implementation.
Syntax
typedef HRESULT ( CALLBACK *LPFNDFMCALLBACK)(
_In_opt_ IShellFolder *psf,
_In_opt_ HWND hwnd,
_In_opt_ IDataObject *pdtobj,
UINT uMsg,
WPARAM wParam,
LPARAM lParam
);
Parameters
- psf [in, optional]
-
Type: IShellFolder*
A pointer to the IShellFolder object the message applies to. This value can be NULL.
- hwnd [in, optional]
-
Type: HWND
The handle of the window that contains the view. This value can be NULL.
- pdtobj [in, optional]
-
Type: IDataObject*
IDataObject that represents the selection the context menu is based on. This value can be NULL.
- uMsg
-
Type: UINT
One of the following notifications.
Notification Usage DFM_MERGECONTEXTMENU Sent by the default context menu implementation to allow LPFNDFMCALLBACK to add items to the menu. DFM_INVOKECOMMAND Sent by the default context menu implementation to request LPFNDFMCALLBACK to invoke a menu command. DFM_GETDEFSTATICID Sent by the default context menu implementation when the default menu command is being created, allowing an alternate choice to be made. - wParam
-
Type: WPARAM
Additional information. See the individual notification pages for specific requirements.
- lParam
-
Type: LPARAM
Additional information. See the individual notification pages for specific requirements.
Return value
Type: HRESULT
Returns S_OK if the message was handled, or an error value otherwise, including the following:
| Return code | Description |
|---|---|
|
The message was not handled. |
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
End of client support |
Windows XP with SP2 |
|
End of server support |
Windows Server 2003 |
|
Header |
|