SHAREVISTRING 消息

[从 Windows Vista 开始， “打开 ”和“ 另存为 ”常用对话框已被 “通用项”对话框取代。 建议使用通用项对话框 API，而不是通用对话框库中的这些对话框。]

如果用户单击“确定”按钮时所选文件发生共享冲突，则打开或另存为对话框会将 SHAREVISTRING 注册的消息发送到挂钩过程 OFNHookProc。

#define SHAREVISTRING TEXT("commdlg_ShareViolation")

参数

wParam

未使用此参数。

lParam

指向 OPENFILENAME 结构的指针。 此结构的 lpstrFile 成员包含导致共享冲突的文件名。

返回值

挂钩过程必须返回以下值之一，以指示对话框应如何处理共享冲突。

返回代码/值	说明
OFN_SHAREFALLTHROUGH 2	接受文件名
OFN_SHARENOWARN 1	拒绝文件名，但不警告用户。 应用程序负责显示警告消息。
OFN_SHAREWARN 0	拒绝文件名并显示警告消息， (结果与没有挂钩过程) 相同。

备注

挂钩过程必须在对 RegisterWindowMessage 函数的调用中指定 SHAREVISTRING 常量，以获取对话框发送的消息的标识符。

仅当您在创建对话框时未在 OPENFILENAME 结构的 Flags 成员中指定 OFN_SHAREAWARE 标志时，对话框才会发送 SHAREVISTRING 注册的消息。

如果挂钩过程返回未定义的值，则对话框会像返回 OFN_SHAREWARN 一样做出响应。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Commdlg.h (包括 Windows.h)
Unicode 和 ANSI 名称	SHAREVISTRINGW (Unicode) 和 SHAREVISTRINGA (ANSI)

另请参阅

引用

CDN_SHAREVIOLATION

OPENFILENAME

RegisterWindowMessage

概念性

通用对话框库