Metode IBitsTokenOptions::SetHelperToken (bits4_0.h)
Mengatur token pembantu untuk meniru token klien COM. Karena aplikasi menetapkan token melalui peniruan COM, token tidak persisten dan hanya berlaku untuk masa pakai sesi. Ketika layanan BITS menerima pemberitahuan log-off, layanan BITS membuang token pembantu yang terkait dengan pekerjaan transfer.
Sintaks
HRESULT SetHelperToken();
Mengembalikan nilai
Nilai berikut mungkin dikembalikan:
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Pengaturan COM pada klien tidak mengizinkan akses tingkat peniruan ke token klien. |
|
|
Keterangan
Token pembantu tidak perlu mewakili administrator.
Tingkat peniruan untuk selimut proksi harus diatur ke RPC_C_IMP_LEVEL_IMPERSONATE atau RPC_C_IMP_LEVEL_DELEGATE. Untuk informasi selengkapnya, lihat Negosiasi Selimut Keamanan.
Bendera penyelubungan harus diatur ke EOAC_DYNAMIC_CLOAKING, yang memungkinkan server COM untuk menggunakan token utas sebagai identitas klien. Untuk informasi selengkapnya, lihat Cloaking dan enumerasi EOLE_AUTHENTICATION_CAPABILITIES.
Implementasi lama secara efektif mengharuskan pengguna BITS memiliki hak istimewa administrator untuk mengatur token pembantu. Dimulai dengan Windows 10, versi 1607, pengguna BITS non-administrator dapat menggunakan IBitsTokenOptions::SetHelperToken untuk mengatur token pembantu non-administrator 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 mengatur token pembantu.
Secara khusus, implementasi telah diubah untuk memungkinkan pengguna tanpa hak istimewa administrator untuk mengatur token pembantu, selama SID token utas penelepon sama dengan SID akun pengguna pemilik pekerjaan selama panggilan IBackgroundCopyJob::QueryInterface , dan token pembantu yang ditetapkan tidak mengaktifkan SID administrator (DOMAIN_ALIAS_RID_ADMINS).
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 |