Поделиться через

Сообщение SHAREVISTRING

  • Статья

[Начиная с Windows Vista, общие диалоговые окна "Открыть" и "Сохранить как" заменены диалоговым окном "Общий элемент". Мы рекомендуем использовать API общих диалоговых окон вместо этих диалоговых окон из библиотеки общих диалоговых окон.]

Диалоговое окно Открыть или Сохранить как отправляет зарегистрированное сообщение SHAREVISTRING в процедуру перехватчика OFNHookProc, если для выбранного файла происходит нарушение общего доступа, когда пользователь нажимает кнопку ОК .

#define SHAREVISTRING TEXT("commdlg_ShareViolation")

Параметры

wParam

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

lParam

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

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

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

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

Комментарии

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

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

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

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Commdlg.h (включая Windows.h)
Имя в кодировке Юникод и ANSI
 SHAREVISTRINGW (Юникод) и SHAREVISTRINGA (ANSI)

См. также раздел

Справочные материалы

CDN_SHAREVIOLATION

OPENFILENAME

RegisterWindowMessage

Основные понятия

Общая библиотека диалоговых окон