Функция 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

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

[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 , чтобы задать этот расширенный код ошибки, который может включать следующие коды возврата.

Комментарии

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

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

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

Требования

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

NPGetPropertyText

SetLastError