CDN_SHAREVIOLATION notification code

[Starting with Windows Vista, the Open and Save As common dialog boxes have been superseded by the Common Item Dialog. We recommended that you use the Common Item Dialog API instead of these dialog boxes from the Common Dialog Box Library.]

Sent by an Explorer-style Open or Save As dialog box when the user clicks the OK button and a network sharing violation occurs for the selected file.

Your OFNHookProc hook procedure receives this message in the form of a WM_NOTIFY message.

#define CDN_FIRST               (0U-601U)
#define CDN_SHAREVIOLATION      (CDN_FIRST - 0x0003)

Parameters

wParam

This parameter is not used.

lParam

A pointer to an OFNOTIFY structure. The pszFile member of this structure is a pointer to the name of the file that had the sharing violation. The OFNOTIFY structure contains an NMHDR structure whose code member indicates the CDN_SHAREVIOLATION notification message.

Return value

The return value indicates how the dialog box should handle the sharing violation.

If the hook procedure returns zero, the dialog box displays the standard warning message for a sharing violation.

To prevent the display of the standard warning message, return a nonzero value from the hook procedure and call the SetWindowLong function to set one of the following DWL_MSGRESULT values.

Return code/value Description
OFN_SHAREFALLTHROUGH
2
Causes the dialog box to return the file name without warning the user about the sharing violation.
OFN_SHARENOWARN
1
Causes the dialog box to reject the file name without warning the user about the sharing violation.

Remarks

The system sends this notification only if the dialog box was created using the OFN_EXPLORER value.

The system sends this notification only if the OFN_SHAREAWARE value was not specified when the dialog box was created.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Commdlg.h (include Windows.h)

See also

Reference

GetOpenFileName

GetSaveFileName

OFNHookProc

OFNOTIFY

OPENFILENAME

SetWindowLong

Conceptual

Common Dialog Box Library