Функция DSCreateISecurityInfoObject (dssec.h)

  • Статья

Функция DSCreateISecurityInfoObject создает экземпляр интерфейса ISecurityInformation, связанного с указанным объектом службы каталогов (DS).

Синтаксис

HRESULT DSCreateISecurityInfoObject(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Параметры

[in] pwszObjectPath

Полный путь к объекту DS, для которого создается экземпляр интерфейса ISecurityInformation .

[in] pwszObjectClass

Класс объекта, заданного параметром pwszObjectPath .

[in] dwFlags

Флаги, используемые для страницы свойств безопасности, связанной с новым экземпляром интерфейса ISecurityInformation . Этот параметр может быть любым сочетанием следующих флагов.

Значение Значение
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] ppSI

Указатель на экземпляр интерфейса ISecurityInformation , создаваемого этой функцией.

[in, optional] pfnReadSD

Указатель на функцию, используемую для чтения дескриптора безопасности объекта . Это значение может иметь значение NULL. Если значение pfnReadSD не равно NULL, DSCreateISecurityInfoObject вызывает функцию, на которую ссылается pfnReadSD , чтобы получить дескриптор безопасности объекта .

[in, optional] pfnWriteSD

Указатель на функцию, используемую для записи дескриптора безопасности объекта . Это значение может иметь значение NULL. Если pfnWriteSD не равно NULL, DSCreateISecurityInfoObject вызывает функцию, на которую ссылается pfnWriteSD , для записи дескриптора безопасности объекта .

[in] lpContext

Контекст для передачи в функции, определяемые параметрами pfnReadSD и pfnWriteSD .

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

Если функция завершается успешно, функция возвращает S_OK.

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования

   
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header dssec.h
Библиотека DSSec.lib
DLL DSSec.dll