Функция BinarySDToSecurityDescriptor (adshlp.h)

Статья
03/14/2023

Функция BinarySDToSecurityDescriptor преобразует двоичный дескриптор безопасности в объект IADsSecurityDescriptor .

Синтаксис

HRESULT BinarySDToSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] VARIANT              *pVarsec,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

Параметры

[in] pSecurityDescriptor

Тип: PSECURITY_DESCRIPTOR

Адрес преобразуемой структуры SECURITY_DESCRIPTOR .

[out] pVarsec

Тип: VARIANT*

Адрес объекта VARIANT , получающего объект . VARIANT содержит объект VT_DISPATCH, к которому можно запросить интерфейс IADsSecurityDescriptor. Вызывающий объект должен освободить этот variant , передав variant в функцию VariantClear .

[in] pszServerName

Тип: LPCWSTR

Строка Юникода, завершающаяся значением NULL, которая предоставляет имя сервера, с которого был получен дескриптор безопасности. Этот параметр является необязательным и может иметь значение NULL.

[in] userName

Тип: LPCWSTR

Строка Юникода, завершающаяся null, которая предоставляет имя пользователя, связанное с дескриптором безопасности. Этот параметр является необязательным и может иметь значение NULL.

[in] passWord

Тип: LPCWSTR

Строка Юникода с символом null, которая предоставляет пароль, связанный с дескриптором безопасности. Этот параметр является необязательным и может иметь значение NULL.

[in] dwFlags

Тип: DWORD

Содержит флаги проверки подлинности для преобразования. Это может быть ноль или сочетание одного или нескольких значений перечисления ADS_AUTHENTICATION_ENUM .

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

Тип: HRESULT

Этот метод поддерживает стандартные возвращаемые значения, а также следующие:

Если операция завершается сбоем, возвращается код ошибки ADSI. Дополнительные сведения см. в разделе Коды ошибок ADSI.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	adshlp.h
Библиотека	Activeds.lib
DLL	Activeds.dll