Метод 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 в противном случае. Возможные коды ошибок включают следующие.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | iads.h |
| DLL | Activeds.dll |