Bagikan melalui

Metode IBitsTokenOptions::GetHelperTokenFlags (bits4_0.h)

  • Artikel

Mengembalikan bendera penggunaan untuk token yang terkait dengan pekerjaan transfer BITS.

Sintaks

HRESULT GetHelperTokenFlags(
  [out] DWORD *pFlags
);

Parameter

[out] pFlags

Menentukan bendera penggunaan yang akan dikembalikan. Parameter ini harus diatur ke salah satu nilai berikut:

Nilai Makna
BG_TOKEN_LOCAL_FILE
0x0001
 Jika bendera ini ditentukan, token pembantu akan 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 upload-reply
BG_TOKEN_NETWORK
0x0002
 Jika bendera ini ditentukan, token pembantu akan digunakan
  • Untuk membuka file jarak jauh pekerjaan pengunggahan atau pengunduhan Blok Pesan Server (SMB)
  • Menanggapi server HTTP atau tantangan proksi untuk kredensial NTLM atau Kerberos implisit
Aplikasi diperlukan untuk memanggil metode IBackgroundCopyJob2::SetCredentials untuk memungkinkan kredensial dikirim melalui HTTP.

Nilai kembali

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

Keterangan

Implementasi lama secara efektif mengharuskan pengguna BITS memiliki hak istimewa administrator untuk mendapatkan bendera token pembantu dengan metode ini. Dimulai dengan Windows 10, versi 1607, pengguna BITS non-administrator dapat menggunakan metode ini untuk mendapatkan bendera penggunaan 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 bendera token pembantu, selama SID token utas penelepon 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