IBackgroundCopyJob::Metode TakeOwnership (bits.h)
Mengubah kepemilikan pekerjaan ke pengguna saat ini.
Sintaks
HRESULT TakeOwnership();
Mengembalikan nilai
Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.
Menampilkan kode | Deskripsi |
---|---|
|
Kepemilikan pekerjaan berhasil diubah. |
|
Status pekerjaan tidak dapat BG_JOB_STATE_CANCELLED atau BG_JOB_STATE_ACKNOWLEDGED. |
|
Pemilik baru tidak memiliki cukup akses ke file sementara pada komputer klien. BITS membuat file sementara menggunakan izin keamanan pemilik. |
|
Pemetaan drive jaringan pemilik saat ini untuk file lokal berbeda dari pemilik sebelumnya. |
|
Pengguna tidak memiliki hak istimewa administrator. |
Keterangan
Untuk mengambil kepemilikan pekerjaan, pengguna harus memiliki hak istimewa administrator pada klien. Pada Windows Vista, pengguna harus berjalan dalam status ditingkatkan. Setelah mengambil kepemilikan, setiap pembaruan pekerjaan di masa mendatang harus dilakukan saat pengguna berjalan dalam keadaan ditinggikan. Untuk detailnya, lihat Pengguna dan Connections Jaringan.
Administrator tidak perlu mengambil kepemilikan atas pekerjaan pengguna lain untuk mengubah propertinya atau menambahkan file ke pekerjaan tersebut. Biasanya, administrator menggunakan metode TakeOwnership jika pengguna tidak memiliki izin yang memadai untuk menyelesaikan pekerjaan atau jika pengguna tidak masuk dan administrator memerlukan pekerjaan untuk diselesaikan.
Setelah kepemilikan pekerjaan berubah, pekerjaan hanya diproses ketika pemilik baru masuk ke klien. Panggil metode IBackgroundCopyJob::GetOwner untuk mengambil SID pemilik baru.
Jika administrator membatalkan pekerjaan setelah mengambil kepemilikan, ada kemungkinan bahwa file mungkin yatim piatu karena administrator tidak memiliki izin menulis ke file. Ini dapat terjadi jika tujuan file lokal berada di profil roaming pengguna sebelumnya.
Metode TakeOwnership menghapus kredensial, sertifikat, header kustom, dan pemberitahuan baris perintah dari pekerjaan, jika diatur.
Jika pekerjaan menentukan pemberitahuan peristiwa, panggilan balik dijalankan dalam konteks pengguna yang memanggil metode IBackgroundCopyJob::SetNotifyInterface .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP |
Server minimum yang didukung | Windows Server 2003 |
Target Platform | Windows |
Header | bits.h |
Pustaka | Bits.lib |
DLL | QmgrPrxy.dll |
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