IBitsTokenOptions：：SetHelperToken 方法 (bits4_0.h)

設定協助程式令牌以模擬 COM 用戶端的令牌。 由於應用程式會透過 COM 模擬來設定令牌，因此令牌不是持續性的，而且只有在會話的存留期內才有效。 當 BITS 服務收到註銷通知時，BITS 服務會捨棄與傳輸作業相關聯的任何協助程式令牌。

Syntax

HRESULT SetHelperToken();

傳回值

可能會傳回下列值：

備註

協助程式令牌不需要代表系統管理員。

Proxy 主體的模擬層級必須設定為 RPC_C_IMP_LEVEL_IMPERSONATE 或 RPC_C_IMP_LEVEL_DELEGATE。 如需詳細資訊，請參閱 安全性交涉。

遮罩旗標應該設定為 EOAC_DYNAMIC_CLOAKING，讓 COM 伺服器能夠使用線程令牌作為用戶端的身分識別。 如需詳細資訊，請參閱 Cloaking 和 EOLE_AUTHENTICATION_CAPABILITIES 列舉。

舊版實作實際上需要 BITS 使用者具有系統管理員許可權，才能設定協助程式令牌。 從 Windows 10 版本 1607 開始，非系統管理員 BITS 使用者可以使用 IBitsTokenOptions：：SetHelperToken，在他們擁有的 BITS 作業上設定非系統管理員協助程式令牌。 這項變更可讓非系統管理員 BITS 使用者 (，例如在 NetworkService 帳戶 下執行的背景下載程式服務) 來設定協助程式令牌。

具體來說，只要呼叫端線程令牌的 SID 與作業擁有者的用戶帳戶在 IBackgroundCopyJob：：QueryInterface 呼叫期間所設定的協助程式令牌，且所設定的協助程式令牌與啟用的 IBackgroundCopyJob：：QueryInterface 呼叫期間，作業擁有者的用戶帳戶 SID 相同，且設定的協助程式令牌不會有系統管理員 SID () DOMAIN_ALIAS_RID_ADMINS 啟用。

規格需求

另請參閱

IBitsTokenOptions