Уведомление SHAREVISTRING

Диалоговое окно Открыть (Open) или Сохранить как (Save As) отправляет зарегистрированное сообщение SHAREVISTRING вашей фильтр - процедуре OFNHookProc тогда, если при выборе файла происходит ошибка совместного доступа, когда пользователь щелкает мышью по кнопке OK.

Синтаксис

SHAREVISTRING
    WPARAM wParam
    lpOpenFileName = (LPOPENFILENAME) lParam;

Параметры

wParam

Этот параметр не используется.

lpOpenFileName

Указатель на структуру OPENFILENAME. Член lpstrFile этой структуры содержит имя файла, который стал причиной ошибки совместного доступа.

Возвращаемое значение

Фильтр - процедура должна возвратить одно из следующих значений, чтобы указать, как диалоговое окно должно обработать ошибку совместного доступа:

Возвращаемое значение	Преднаначение
OFN_SHAREFALLTHROUGH	Принять имя файла.
OFN_SHARENOWARN	Отклоняется имя файла, но пользователь не предупреждается. Прикладная программа ответственна за отображение на экране предупреждающего сообщения.
OFN_SHAREWARN	Отклоняется имя файла и отображается предупреждающее сообщение (тот же самый результат, как будто нет никакой фильтр - процедуры).

Замечания

Фильтр - процедура должна определить константу SHAREVISTRING при вызове функции RegisterWindowMessage, чтобы получить идентификатор сообщения, отправленного блоком диалога.

Диалоговое окно отправляет зарегистрированное сообщение SHAREVISTRING, только тогда, если вы, когда создавали диалог, не определили флажок OFN_SHAREAWARE в члене Flags структуры OPENFILENAME.

Если фильтр - процедура возвращает неопределенное значение, блок диалога реагирует, как если бы было возвращено значение OFN_SHAREWARN.

Смотри также

Обзор Библиотека стандартных диалоговых окон, Уведомления, используемые библиотекой стандартных диалоговых окон, CDN_SHAREVIOLATION, OPENFILENAME, RegisterWindowMessage

Размещение и совместимость SHAREVISTRING
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Минимальная версия DLL	Нет
Заголовочный файл
- объявлено в	Commdlg.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки