IADsSecurityUtility：：ConvertSecurityDescriptor 方法 (iads.h)

ConvertSecurityDescriptor 方法将安全描述符从一种格式转换为另一种格式。

语法

HRESULT ConvertSecurityDescriptor(
  [in]  VARIANT varSD,
  [in]  long    lDataFormat,
  [in]  long    lOutFormat,
  [out] VARIANT *pResult
);

parameters

[in] varSD

包含要转换的安全描述符的 VARIANT 。 此 VARIANT 的格式由 lDataFormat 参数定义。

[in] lDataFormat

包含指定 varSD 参数中安全描述符格式的ADS_SD_FORMAT_ENUM值之一。 以下列表标识此参数的可能值和 varSD 参数的格式。

ADS_SD_FORMAT_IID

varSD 包含可查询 IADsSecurityDescriptor 接口的VT_DISPATCH。

ADS_SD_FORMAT_RAW

varSD 包含一个 VT_I1 | VT_ARRAY ，其中包含原始数据格式的安全描述符。 这是 SECURITY_DESCRIPTOR 结构的格式。

ADS_SD_FORMAT_HEXSTRING

varSD 包含一个 VT_BSTR ，其中包含十六进制编码字符串格式的原始安全描述符。

[in] lOutFormat

包含 ADS_SD_FORMAT_ENUM 值之一，该值指定应将安全描述符转换为的格式。 以下列表标识此参数的可能值和 pvResult 参数的格式。

ADS_SD_FORMAT_IID

pvResult 接收可查询 IADsSecurityDescriptor 接口的VT_DISPATCH。

ADS_SD_FORMAT_RAW

pvResult 接收包含原始数据格式的安全描述符的 VT_I1 | VT_ARRAY 。 这是 SECURITY_DESCRIPTOR 结构的格式。

ADS_SD_FORMAT_HEXSTRING

pvResult 接收包含十六进制编码字符串格式的原始安全描述符 的VT_BSTR 。

[out] pResult

指向接收转换后的安全描述符的 VARIANT 的指针。 检索到的安全描述符的格式由 lOutFormat 参数指定。

返回值

如果成功 ， 则返回S_OK，否则返回 COM 或 Win32 错误代码。 可能的错误代码包括以下内容。

要求

最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	iads.h
DLL	Activeds.dll

另请参阅

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility