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 參數的格式。

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 參數所指定。

傳回值

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

需求

最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	iads.h
Dll	Activeds.dll

另請參閱

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility