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
CO_E_FAILEDTOIMPERSONATE 0x80010123	Pengaturan COM pada klien tidak mengizinkan akses tingkat peniruan ke token klien.
E_ACCESSDENIED 0x80070005	Dalam versi sebelum Windows 10, versi 1607, pekerjaan tidak dimiliki oleh administrator. Dalam versi Windows tersebut, hanya pekerjaan milik administrator yang dapat mengatur token pembantu. Dalam Windows 10, versi 1607 dan versi yang lebih baru, kesalahan ini menunjukkan bahwa token pembantu memiliki hak istimewa administrator, tetapi pemanggil tidak memiliki hak istimewa administrator.

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

Lihat juga

IBitsTokenOptions