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

Статья
08/22/2023

Функция SecurityDescriptorToBinarySD преобразует объект IADsSecurityDescriptor в формат двоичного дескриптора безопасности.

Синтаксис

HRESULT SecurityDescriptorToBinarySD(
  [in]  VARIANT              vVarSecDes,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] PDWORD               pdwSDLength,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

Параметры

[in] vVarSecDes

Тип: VARIANT

Содержит variant , содержащий преобразуемый дескриптор безопасности. Variant должен содержать VT_DISPATCH, содержащий объект IADsSecurityDescriptor.

[out] ppSecurityDescriptor

Тип: PSECURITY_DESCRIPTOR*

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

[out] pdwSDLength

Тип: PDWORD

Адрес значения DWORD , получающего длину в байтах данных двоичного дескриптора безопасности.

[in] pszServerName

Тип: LPCWSTR

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

[in] userName

Тип: LPCWSTR

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

[in] passWord

Тип: LPCWSTR

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

[in] dwFlags

Тип: DWORD

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

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

Тип: HRESULT

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

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

Требования

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