binarySDToSecurityDescriptor 函数 (adshlp.h)

项目
02/26/2024

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 包含可查询 IADsSecurityDescriptor 接口的 VT_DISPATCH 对象。调用方必须通过将 VARIANT 传递给 VariantClear 函数来释放此 VARIANT。

[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

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

如果操作失败，则返回 ADSI 错误代码。有关详细信息，请参阅 ADSI 错误代码。

注解

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

要求

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