IBitsTokenOptions：：GetHelperTokenSid 方法 (bits4_0.h)

如果已設定協助程式令牌，則傳回 SID。

語法

HRESULT GetHelperTokenSid(
  [out] LPWSTR *pSid
);

參數

[out] pSid

傳回從 GetTokenInformation 函式之 TokenInformation 參数擷取的 SID。 如果未擷取 SID，此參數會設定為 NULL。

傳回值

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

備註

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

具體來說，實作已變更為允許沒有系統管理員許可權的使用者取得協助程式令牌 SID，只要呼叫端線程令牌的 SID 與作業擁有者用戶帳戶在 IBackgroundCopyJob：：QueryInterface 呼叫期間的 SID 相同。

規格需求

另請參閱

IBitsTokenOptions