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

[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.

Требования