共用方式為

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 伺服器或 Proxy 挑戰
需要應用程式才能呼叫 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