Функция ADsPropCheckIfWritable (adsprop.h)
Функция ADsPropCheckIfWritable определяет, можно ли записать атрибут.
Синтаксис
BOOL ADsPropCheckIfWritable(
[in] const PWSTR pwzAttr,
[in] const PADS_ATTR_INFO pWritableAttrs
);
Параметры
[in] pwzAttr
Указатель на буфер WCHAR с завершением NULL, который содержит имя атрибута.
[in] pWritableAttrs
Указатель на массив ADS_ATTR_INFO структур, возвращаемых ADsPropGetInitInfo.
Возвращаемое значение
Возвращает ненулевое значение, если атрибут найден в списке атрибутов, доступных для записи, или ноль в противном случае. Также возвращает ноль, если pWritableAttrs имеет значение NULL.
Комментарии
Во время инициализации расширение страницы свойств должно определять, можно ли записывать атрибуты с помощью ADsPropCheckIfWritable. Если атрибут не может быть записан, он должен отображаться как доступный только для чтения, а возможность изменять значение атрибута должна быть удалена.
Пользователю может быть предоставлено разрешение на запись, но не разрешение на чтение атрибута. В этом случае операция чтения атрибута завершается сбоем, и возможно, что атрибут может быть перезаписан. Следовательно, не рекомендуется предоставлять пользователю разрешение на запись, но отменять разрешение на чтение атрибута.
Не используйте эту функцию для проверки разрешения на запись для атрибутов на странице свойств с несколькими выборами. Вполне вероятно, что каждый объект каталога будет иметь свой набор разрешений на запись атрибутов. Расширение страницы свойств должно полагаться на сервер, возвращающий ошибку при попытке выполнить запись в определенный объект в выбранной группе, чтобы определить, запрещены ли разрешения на запись для этого объекта.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | adsprop.h |
| Библиотека | Dsprop.lib |
| DLL | Dsprop.dll |