Функция DSCreateSecurityPage (dssec.h)
Функция DSCreateSecurityPage создает страницу свойств безопасности для объекта Active Directory. Полученную страницу свойств можно добавить на страницу свойств.
Синтаксис
HRESULT DSCreateSecurityPage(
[in] LPCWSTR pwszObjectPath,
[in, optional] LPCWSTR pwszObjectClass,
[in] DWORD dwFlags,
[out] HPROPSHEETPAGE *phPage,
[in, optional] PFNREADOBJECTSECURITY pfnReadSD,
[in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
[in] LPARAM lpContext
);
Параметры
[in] pwszObjectPath
Указатель на строку расширенных символов, завершающуюся null, которая представляет полный путь Active Directory к объекту.
[in, optional] pwszObjectClass
Указатель на строку расширенных символов, завершающуюся null, которая представляет класс объекта. Это значение может иметь значение NULL.
[in] dwFlags
Флаги, используемые для страницы свойств безопасности. Этот параметр может иметь значение none или любое сочетание следующих флагов.
Значение | Значение |
---|---|
|
Свойства безопасности доступны только для чтения. |
|
Проверка доступа не выполняется. |
|
Свойство системного списка управления доступом (SACL) доступно только для чтения. |
|
Свойство владельца объекта доступно только для чтения. |
|
Объект является корневым объектом. |
|
Не применяйте фильтры. |
|
Подавлять всплывающие сообщения только для чтения. |
[out] phPage
Указатель на HPROPSHEETPAGE , который возвращает созданную страницу свойств безопасности.
[in, optional] pfnReadSD
Указатель на функцию, используемую для чтения дескриптора безопасности объекта . Это значение может иметь значение NULL. Если pfnReadSD не равно NULL, DSCreateSecurityPage вызывает функцию, на которую ссылается pfnReadSD , чтобы получить дескриптор безопасности объекта .
[in, optional] pfnWriteSD
Указатель на функцию, используемую для записи дескриптора безопасности объекта . Это значение может иметь значение NULL. Если pfnWriteSD не равно NULL, DSCreateSecurityPage вызывает функцию, на которую ссылается pfnWriteSD , для записи дескриптора безопасности объекта .
[in] lpContext
Контекст для передачи в функции, определяемые pfnReadSD или pfnWriteSD.
Возвращаемое значение
Если функция завершается успешно, функция возвращает S_OK.
Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
Комментарии
Функция, на которую указывает pfnReadSD , определяется следующим образом.
#include <windows.h>
typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
LPCWSTR, // Active Directory path of object
SECURITY_INFORMATION, // the security information to read
PSECURITY_DESCRIPTOR*, // the returned security descriptor
LPARAM // context parameter
);
Функция DSCreateSecurityPage освободит дескриптор безопасности, возвращенный в третьем параметре выше путем вызова функции LocalFree .
Функция, на которую указывает pfnWriteSD , определяется следующим образом.
#include <windows.h>
typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
LPCWSTR, // Active Directory path of object
SECURITY_INFORMATION, // the security information to write
PSECURITY_DESCRIPTOR, // the security descriptor to write
LPARAM // context parameter
);
Требования
Минимальная версия клиента | Ни одна версия не поддерживается |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | dssec.h |
Библиотека | DSSec.lib |
DLL | DSSec.dll |