Metode IBitsTokenOptions::GetHelperTokenSid (bits4_0.h)

Mengembalikan SID token pembantu jika ditetapkan.

Catatan Metode ini tidak mengembalikan token.

 

Sintaks

HRESULT GetHelperTokenSid(
  [out] LPWSTR *pSid
);

Parameter

[out] pSid

Mengembalikan SID yang diambil dari parameter TokenInformation dari fungsi GetTokenInformation . Jika tidak ada SID yang diambil, parameter ini diatur ke NULL.

Menampilkan nilai

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Implementasi lama secara efektif mengharuskan pengguna BITS memiliki hak istimewa administrator untuk mendapatkan SID token pembantu dengan metode ini. Dimulai dengan Windows 10, versi 1607, pengguna BITS non-administrator dapat menggunakan metode ini untuk mendapatkan SID token pembantu pada pekerjaan BITS yang mereka miliki. Perubahan ini memungkinkan pengguna BITS non-administrator (seperti layanan pengunduh latar belakang yang berjalan di bawah akun NetworkService) untuk menggunakan token pembantu secara efektif.

Secara khusus, implementasi telah diubah untuk memungkinkan pengguna tanpa hak istimewa administrator untuk mendapatkan SID token pembantu, selama SID token utas pemanggil sama dengan SID akun pengguna pemilik pekerjaan selama panggilan IBackgroundCopyJob::QueryInterface .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	bits4_0.h
Redistribusi	Windows Management Framework di Windows Vista dengan SP1, Windows Vista dengan SP2, dan Windows Server 2008 dengan SP2

Lihat juga

IBitsTokenOptions