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

  • Статья

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

Синтаксис

HRESULT DSCreateISecurityInfoObjectEx(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           LPCWSTR                pwszServer,
  [in]           LPCWSTR                pwszUserName,
  [in]           LPCWSTR                pwszPassword,
  [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] pwszServer

Сервер объекта, указанного параметром pwszObjectPath . Если значение этого параметра равно NULL, сервер получается по пути, указанному параметром pwszObjectPath .

[in] pwszUserName

Имя пользователя, связанное с новым объектом ISecurityInformation . Если этот параметр имеет значение NULL, используется значение по умолчанию Интерфейсы служб Active Directory (ADSI).

[in] pwszPassword

Пароль, связанный с новым объектом ISecurityInformation . Если этот параметр имеет значение NULL, используется значение по умолчанию Интерфейсы служб Active Directory (ADSI).

[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