Метод 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 содержит VT_DISPATCH , который можно запросить для интерфейса IADsSecurityDescriptor .

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 получает VT_DISPATCH , которую можно запросить для интерфейса IADsSecurityDescriptor .

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 в противном случае. Возможные коды ошибок включают следующие.

Требования

См. также раздел

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility