Share via

Метод IBitsTokenOptions::GetHelperTokenSid (bits4_0.h)

  • Статья

Возвращает идентификатор безопасности вспомогательного маркера, если он задан.

Примечание Этот метод не возвращает маркер.

 

Синтаксис

HRESULT GetHelperTokenSid(
  [out] LPWSTR *pSid
);

Параметры

[out] pSid

Возвращает идентификатор безопасности, полученный из параметра TokenInformation функции GetTokenInformation . Если идентификатор безопасности не получен, этот параметр имеет значение NULL.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает 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)

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

IBitsTokenOptions