Метод IUrlAccessor::GetSecurityDescriptor (searchapi.h)
Возвращает дескриптор безопасности для элемента URL-адреса. Безопасность применяется во время запроса, поэтому этот дескриптор определяет безопасность для доступа на чтение.
Синтаксис
HRESULT GetSecurityDescriptor(
[out] BYTE *pSD,
[in] DWORD dwSize,
[out] DWORD *pdwLength
);
Параметры
[out] pSD
Тип: BYTE*
Получает указатель на дескриптор безопасности.
[in] dwSize
Тип: DWORD
Размер массиваpSD в TCHAR.
[out] pdwLength
Тип: DWORD*
Получает указатель на количество объектов TCHAR, записанных в pSD, не включая завершающее значение NULL.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Этот метод позволяет выполнять пользовательские сопоставления между пользователями, зарегистрированными в источнике контента, и пользователями, зарегистрированными в домене, если они отличаются. Дескрипторы безопасности, созданные в этом методе, должны быть самосообъективными.
Если URL-адрес содержит идентификатор безопасности пользователя (SID), обработчик протокола вызывается в контексте безопасности этого пользователя, и этот метод должен возвращать E_NOTIMPL.
Если URL-адрес не содержит идентификатор безопасности пользователя, обработчик протокола вызывается в контексте безопасности системной службы. В этом случае этот метод может возвращать либо список управления доступом (ACL), чтобы ограничить доступ на чтение, либо PRTH_S_ACL_IS_READ_EVERYONE , чтобы разрешить любому пользователю доступ на чтение во время запроса.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2), Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения] |
| Целевая платформа | Windows |
| Header | searchapi.h |
| Распространяемые компоненты | Windows Desktop Search (WDS) 3.0 |