Метод IBitsTokenOptions::ClearHelperToken (bits4_0.h)
Отменяет вспомогательный маркер и не изменяет флаги использования.
Синтаксис
HRESULT ClearHelperToken();
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Более старые реализации фактически требовали, чтобы пользователи BITS имели права администратора для очистки вспомогательного маркера с помощью этого метода. Начиная с Windows 10 версии 1607 пользователи BITS без прав администратора могут использовать этот метод для очистки вспомогательных маркеров в заданиях BITS, которыми они владеют. Это изменение позволяет пользователям BITS без прав администратора (например, фоновым службам загрузчика, работающим под учетной записью NetworkService) эффективно использовать вспомогательные маркеры.
В частности, реализация была изменена, чтобы позволить пользователям без прав администратора очищать вспомогательный маркер, если идентификатор безопасности маркера потока вызывающего объекта совпадает с идентификатором безопасности учетной записи пользователя владельца задания во время вызова IBackgroundCopyJob::QueryInterface .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 |
| Минимальная версия сервера | Windows Server 2008 R2 |
| Целевая платформа | Windows |
| Header | bits4_0.h |
| Распространяемые компоненты | Windows Management Framework в Windows Vista с пакетом обновления 1 (SP1), Windows Vista с пакетом обновления 2 (SP2) и Windows Server 2008 с пакетом обновления 2 (SP2) |