Метод IUrlAccessor3::GetImpersonationSidBlobs (searchapi.h)
Извлекает массив идентификаторов безопасности пользователей (SID) для указанного URL-адреса. Этот метод позволяет обработчикам протоколов указать, какие пользователи могут получить доступ к файлу, и узел протокола поиска для олицетворения пользователя для индексирования файла.
Синтаксис
HRESULT GetImpersonationSidBlobs(
[in] LPCWSTR pcwszURL,
[out] DWORD *pcSidCount,
[out] BLOB **ppSidBlobs
);
Параметры
[in] pcwszURL
Тип: LPCWSTR
URL-адрес для доступа от имени олицетворенного пользователя.
[out] pcSidCount
Тип: DWORD*
Получает указатель на количество пользовательских идентификаторов БЕЗОПАСНОСТИ, возвращенных в ppSidBlobs.
[out] ppSidBlobs
Тип: BLOB**
Получает адрес указателя на массив идентификаторов безопасности пользователя-кандидата олицетворения.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Если файл зашифрован, этот метод определяет, кто может расшифровать его и получить к нему доступ. Если метод не может определить эти сведения, он завершается сбоем с кодом ошибки E_ACCESSDENIED.
Этот метод предполагает, что объект IUrlAccessor2 не удалось инициализировать и вернул код PRTH_S_TRY_IMPERSONATING. Затем узел протокола поиска вызывает этот метод, чтобы получить список идентификаторов безопасности, используемых для олицетворения, и возвращается к использованию IUrlAccessor2, олицетворяя одного из разрешенных пользователей при открытии элемента.
Олицетворение пользователя не повышает привилегии вызывающего абонента. Если вызывающий объект не может напрямую получить список пользователей, авторизованных для доступа к ресурсу, вызывающий объект также не сможет сделать это с помощью этого метода. Только узел протокола поиска и индексатор имеют достаточные привилегии для олицетворения пользователей, вошедшего в систему.
Требования
| Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2), Windows Vista с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения] |
| Целевая платформа | Windows |
| Header | searchapi.h |
| Распространяемые компоненты | Windows Search (WS) 4.0 |