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

包含其中一個 ADS_SD_FORMAT_ENUM 值，指定 varSD 參數中安全描述項的格式。下列清單會識別此參數的可能值，以及 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 參數所指定。

如果成功或 COM 或 Win32 錯誤碼，則傳回 S_OK 否則傳回。可能的錯誤碼包括下列專案。