Функция NPPropertyDialog (npapi.h)

  • Статья

Вызывается, когда пользователь нажимает кнопку, добавленную с помощью функции NPPropertyDialog . Функция NPPropertyDialog вызывается только для свойств сети файлов и каталогов.

Синтаксис

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

Параметры

[in] hwndParent

Дескриптор родительского окна, которому должно принадлежать диалоговое окно свойства файла.

[in] iButtonDlg

Индекс нажатой кнопки.

Этот индекс указывает, какое диалоговое окно свойства было запрошено, начиная с одного для первой кнопки, возвращенной функцией NPGetPropertyText . Если выбрано несколько имен файлов, к этому числу добавляется 10. Другими словами, если выбрано несколько файлов и пользователь нажимает первую кнопку свойства, определяемого поставщиком, iButtonDlg будет иметь значение 11. Если выбран только один файл и пользователь нажимает вторую кнопку свойства сети, iButtonDlg будет иметь два значения.

[in] nPropSel

Указывает, с какими элементами должно действовать диалоговое окно свойств. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
WNPS_FILE
 Один файл.
WNPS_DIR
 Один каталог.
WNPS_MULT
 Выбор из нескольких файлов, каталогов или и того, и другого.

[in] lpFileName

Указатель на имена элементов, с которыми должно работать диалоговое окно свойств. Поддерживаются только файлы и каталоги, поэтому имена элементов являются именами файлов. Они должны быть однозначными, не содержать подстановочные знаки и быть полными, например C:\Local\Example.doc. Несколько имен файлов должны быть разделены пробелами. Имя файла, содержащее пробелы, можно заключать в кавычки, например "C:\My File". В этом случае оно рассматривается как одно имя. Курсор (^) также можно использовать в качестве механизма кавычек для отдельных символов, например C:\My^"File и C:\My^"File" ссылаются на файл C:\My"File.

[in] nType

Указывает тип элемента, который должен быть WNTYPE_FILE.

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

Если функция выполняется успешно, она возвращает WN_SUCCESS. Если функция завершается сбоем, она возвращает код ошибки. Вызовите SetLastError , чтобы задать этот расширенный код ошибки, который может включать следующие коды возврата.

Код возврата Описание
WN_BAD_VALUE
 Один или несколько параметров являются непредвиденной формой или значением.
WN_OUT_OF_MEMORY
 Недостаточно памяти для отображения диалогового окна.
WN_NET_ERROR
 Произошла сетевая ошибка.

Комментарии

Эта функция вызывается только для наборов свойств, для которых NPGetPropertyText присвоил имя кнопки.

Эта функция используется в диспетчере файлов для просмотра и изменения сетевых свойств (например, разрешений) для файлов на сетевом устройстве. Если эта функция не поддерживается, диспетчер файлов не обеспечивает поведение по умолчанию.

В этой версии интерфейса поставщика lpFileName может указывать только на имена файлов. Поставщик сети должен вернуть WN_BAD_VALUE, если он видит недопустимое устройство.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header npapi.h

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

NPGetPropertyText

SetLastError