IADsSecurityUtility：：ConvertSecurityDescriptor 方法 (iads.h)

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

语法

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

[in] varSD

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

[in] lDataFormat

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

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

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

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

[in] lOutFormat

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

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

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

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

[out] pResult

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

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