SecurityDescriptorToBinarySD 函数 (adshlp.h)

项目
03/05/2024

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 必须包含包含 IADsSecurityDescriptor 对象的VT_DISPATCH。

[out] ppSecurityDescriptor

类型： PSECURITY_DESCRIPTOR*

接收二进制安全描述符数据的 SECURITY_DESCRIPTOR 指针的地址。调用方必须通过将此指针传递给 FreeADsMem 函数来释放此内存。

[out] pdwSDLength

类型： PDWORD

接收二进制安全描述符数据的长度（以字节为单位）的 DWORD 值的地址。

[in] pszServerName

类型： LPCWSTR

以 null 结尾的 Unicode 字符串，指定放置安全描述符的服务器的名称。此参数是可选的，可以为 NULL。

[in] userName

类型： LPCWSTR

一个以 null 结尾的 Unicode 字符串，其中包含安全描述符所关联的用户名。此参数是可选的，可以为 NULL。

[in] passWord

类型： LPCWSTR

一个以 null 结尾的 Unicode 字符串，其中包含安全描述符关联的密码。此参数是可选的，可以为 NULL。

[in] dwFlags

类型：DWORD

包含转换的身份验证标志。这可以是零，也可以是一个或多个 ADS_AUTHENTICATION_ENUM 枚举值的组合。

返回值

类型： HRESULT

此方法支持标准返回值以及以下值。

注解

此函数用于旧版应用程序，以手动将安全描述符转换为二进制安全描述符。对于新应用程序，请使用自动执行此转换的 IADsSecurityUtility。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	adshlp.h
Library	Activeds.lib
DLL	Activeds.dll