Metode IBitsTokenOptions::SetHelperTokenFlags (bits4_0.h)
Mengatur bendera penggunaan untuk token yang terkait dengan pekerjaan transfer BITS.
Sintaks
HRESULT SetHelperTokenFlags(
DWORD UsageFlags
);
Parameter
UsageFlags
Menentukan bendera penggunaan. Parameter ini harus diatur ke salah satu nilai berikut:
Nilai | Makna |
---|---|
|
Jika bendera ini ditentukan, token pembantu digunakan
|
|
Jika bendera ini ditentukan, token pembantu digunakan
|
Nilai kembali
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Bendera penggunaan token pembantu menentukan sumber daya mana yang akan diakses menggunakan konteks keamanan token pembantu. BITS akan mengakses semua sumber daya lain menggunakan konteks keamanan pemilik pekerjaan. Misalnya, sertifikat klien diakses dengan menggunakan identitas pemilik pekerjaan.
Jika sertifikat klien ditentukan dan pemilik pekerjaan BITS bukan akun LocalSystem, mengatur parameter UsageFlag ke BG_TOKEN_NETWORK akan menyebabkan pekerjaan gagal dengan kode kesalahan 0x80072f9a (ERROR_WINHTTP_CLIENT_CERT_NO_ACCESS_PRIVATE_KEY).
Implementasi lama secara efektif mengharuskan pengguna BITS memiliki hak istimewa administrator untuk mengatur bendera penggunaan token pembantu dengan metode ini. Dimulai dengan Windows 10, versi 1607, pengguna BITS non-administrator dapat menggunakan metode ini untuk mengatur bendera penggunaan 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 menggunakan token pembantu secara efektif.
Secara khusus, implementasi telah diubah untuk memungkinkan pengguna tanpa hak istimewa administrator untuk mengatur bendera penggunaan token pembantu, selama SID token utas pemanggil sama dengan SID akun pengguna pemilik pekerjaan selama panggilan IBackgroundCopyJob::QueryInterface , dan token pembantu yang saat ini diatur (jika ada) 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk