Share via

Metode IBitsTokenOptions::SetHelperTokenFlags (bits4_0.h)

  • Artikel

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
BG_TOKEN_LOCAL_FILE
0x0001
 Jika bendera ini ditentukan, token pembantu digunakan
  • Untuk membuka file lokal pekerjaan pengunggahan
  • Untuk membuat atau mengganti nama file sementara dari pekerjaan pengunduhan
  • Untuk membuat atau mengganti nama file balasan dari pekerjaan balasan unggahan
BG_TOKEN_NETWORK
0x0002
 Jika bendera ini ditentukan, token pembantu digunakan
  • Untuk membuka file jarak jauh pekerjaan pengunggahan atau pengunduhan Blok Pesan Server (SMB)
  • Menanggapi server HTTP atau tantangan proksi untuk kredensial implisit NTLM atau Kerberos
Aplikasi diperlukan untuk memanggil IBackgroundCopyJob2::SetCredentials (..., NULL, NULL) untuk memungkinkan kredensial dikirim melalui HTTP.

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

IBitsTokenOptions