Метод IADsSecurityUtility::GetSecurityDescriptor (iads.h)
Метод GetSecurityDescriptor извлекает дескриптор безопасности для указанного файла, общей папки или раздела реестра.
Синтаксис
HRESULT GetSecurityDescriptor(
[in] VARIANT varPath,
[in] long lPathFormat,
[in] long lFormat,
[out] VARIANT *pVariant
);
Параметры
[in] varPath
Строка VARIANT , содержащая путь к объекту, для которого извлекается дескриптор безопасности.
File
Допустимый синтаксис пути к файлу. Например, "c:\specs\public\adxml.doc" или "\adsi\public\dsclient.exe".
Общая папка
Допустимый синтаксис пути к файлу для общей папки. Например: "\adsi\public".
Раздел реестра
Допустимый синтаксис реестра. Например, "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs".
[in] lPathFormat
Содержит одно из ADS_PATHTYPE_ENUM значений, задающее формат параметра varPath .
[in] lFormat
Содержит одно из ADS_SD_FORMAT_ENUM значений, указывающее формат дескриптора безопасности, возвращаемого в параметре pVariant . В следующем списке указаны возможные значения для этого параметра и формат, указанный в параметре pVariant .
ADS_SD_FORMAT_IID
pVariant получает VT_DISPATCH , который можно запросить для интерфейса IADsSecurityDescriptor .
ADS_SD_FORMAT_RAW
pVariant получает VT_I1 | VT_ARRAY , содержащий дескриптор безопасности в формате необработанных данных. Это формат структуры SECURITY_DESCRIPTOR .
ADS_SD_FORMAT_HEXSTRING
pVariant получает VT_BSTR , содержащий необработанный дескриптор безопасности в формате строки шестнадцатеричного кодирования.
[out] pVariant
Указатель на VARIANT , получающий возвращенный дескриптор безопасности. Формат полученного дескриптора безопасности определяется параметром lFormat .
Возвращаемое значение
Возвращает S_OK в случае успешного выполнения или кода ошибки COM или Win32. Возможные коды ошибок включают следующие.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | iads.h |
| DLL | Activeds.dll |