Функция 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 или любое сочетание следующих флагов.

Значение Значение
DSSI_READ_ONLY
0x00000001
 Свойства безопасности доступны только для чтения.
DSSI_NO_ACCESS_CHECK
0x00000002
 Проверка доступа не выполняется.
DSSI_NO_EDIT_SACL
0x00000004
 Свойство системного списка управления доступом (SACL) доступно только для чтения.
DSSI_NO_EDIT_OWNER
0x00000008
 Свойство владельца объекта доступно только для чтения.
DSSI_IS_ROOT
0x00000010
 Объект является корневым объектом.
DSSI_NO_FILTER
0x00000020
 Не применяйте фильтры.
DSSI_NO_READONLY_MESSAGE
0x00000040
 Подавлять всплывающие сообщения только для чтения.

[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

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

Страница базовых свойств безопасности

ISecurityInformation