IBitsTokenOptions：：GetHelperTokenFlags 方法 (bits4_0.h)

返回与 BITS 传输作业关联的令牌的使用标志。

语法

HRESULT GetHelperTokenFlags(
  [out] DWORD *pFlags
);

参数

[out] pFlags

指定要返回的用法标志。 此参数必须设置为以下值之一：

值	含义
BG_TOKEN_LOCAL_FILE 0x0001	如果指定了此标志，则使用帮助程序令牌 打开上传作业的本地文件 创建或重命名下载作业的临时文件 创建或重命名上传-答复作业的回复文件
BG_TOKEN_NETWORK 0x0002	如果指定了此标志，则使用帮助程序令牌 打开服务器消息块的远程文件 (SMB) 上传或下载作业 响应隐式 NTLM 或 Kerberos 凭据的 HTTP 服务器或代理质询 应用程序需要调用 IBackgroundCopyJob2：：SetCredentials 方法，以允许通过 HTTP 发送凭据。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

旧实现实际上要求 BITS 用户具有管理员权限才能使用此方法获取帮助程序令牌标志。 从 Windows 10 版本 1607 开始，非管理员 BITS 用户可以使用此方法获取其拥有的 BITS 作业上的帮助程序令牌使用标志。 此更改使非管理员 BITS 用户 (（如 在 NetworkService 帐户) 下运行的后台下载程序服务）能够有效地使用帮助程序令牌。

具体而言，只要调用方线程令牌的 SID 与 IBackgroundCopyJob：：QueryInterface 调用期间作业所有者用户帐户的 SID 相同，实现已更改为允许没有管理员权限的用户获取帮助程序令牌标志。

要求

要求	值
最低受支持的客户端	Windows 7
最低受支持的服务器	Windows Server 2008 R2
目标平台	Windows
标头	bits4_0.h
可再发行组件	在 Windows Vista SP1、Windows Vista SP2 和 Windows Server 2008 SP2 上Windows Management Framework

另请参阅

IBitsTokenOptions