Метод 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 , чтобы разрешить любому пользователю доступ на чтение во время запроса.

Примечание Если этот метод возвращает E_NOTIMPL, а URL-адрес не содержит идентификатор безопасности пользователя, элемент может быть извлечен всеми запросами пользователей.

 

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2), Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа	Windows
Header	searchapi.h
Распространяемые компоненты	Windows Desktop Search (WDS) 3.0

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

IUrlAccessor

Сообщения об ошибках обработчика протокола поиска