共用方式為

IBitsTokenOptions：：SetHelperTokenFlags 方法 (bits4_0.h)

  • 發行項

設定與 BITS 傳輸作業相關聯之令牌的使用旗標。

語法

HRESULT SetHelperTokenFlags(
  DWORD UsageFlags
);

參數

UsageFlags

指定使用旗標。 此參數必須設定為下列其中一個值：

值 意義
BG_TOKEN_LOCAL_FILE
0x0001
 如果指定此旗標，則會使用協助程式令牌
  • 開啟上傳作業的本機檔案
  • 建立或重新命名下載作業的暫存盤
  • 建立或重新命名上傳-回復作業的回復檔案
BG_TOKEN_NETWORK
0x0002
 如果指定此旗標，則會使用協助程式令牌
  • 若要開啟伺服器消息塊的遠端檔案， (SMB) 上傳或下載作業
  • 回應隱含 NTLM 或 Kerberos 認證的 HTTP 伺服器或 Proxy 挑戰
需要應用程式才能呼叫 IBackgroundCopyJob2：：SetCredentials (...、NULL、NULL) ，以允許透過 HTTP 傳送認證。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

協助程式令牌使用旗標會指定要使用協助程式令牌的安全性內容存取哪些資源。 BITS 會使用作業擁有者的安全性內容來存取所有其他資源。 例如，客戶端憑證是使用作業擁有者身分識別來存取。

如果指定客戶端憑證，而且 BITS 作業的擁有者不是 LocalSystem 帳戶，將 UsageFlag 參數設定為 BG_TOKEN_NETWORK 會導致作業失敗，0x80072f9a (錯誤碼ERROR_WINHTTP_CLIENT_CERT_NO_ACCESS_PRIVATE_KEY) 。

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

具體來說，實作已變更為允許使用者沒有系統管理員許可權的使用者設定協助程式令牌使用旗標， 只要呼叫端線程令牌的 SID 與 IBackgroundCopyJob：：QueryInterface 呼叫期間作業擁有者的使用者帳戶 SID 相同，而且如果有任何) 未啟用系統管理員 SID (DOMAIN_ALIAS_RID_ADMINS，則 目前設定 () 的協助程式令牌。

規格需求

需求 值
最低支援的用戶端 Windows 7
最低支援的伺服器 Windows Server 2008 R2
目標平台 Windows
標頭 bits4_0.h
可轉散發套件 在 Windows Vista 上使用 SP1、Windows Vista sp2 和 Windows Server 2008 SP2 上的 Windows Management Framework

另請參閱

IBitsTokenOptions