IBackgroundCopyJob::Metode TakeOwnership (bits.h)

  • Artikel

Mengubah kepemilikan pekerjaan ke pengguna saat ini.

Sintaks

HRESULT TakeOwnership();

Mengembalikan nilai

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Menampilkan kode Deskripsi
S_OK
 Kepemilikan pekerjaan berhasil diubah.
BG_E_INVALID_STATE
 Status pekerjaan tidak dapat BG_JOB_STATE_CANCELLED atau BG_JOB_STATE_ACKNOWLEDGED.
BG_E_NEW_OWNER_NO_FILE_ACCESS
 Pemilik baru tidak memiliki cukup akses ke file sementara pada komputer klien. BITS membuat file sementara menggunakan izin keamanan pemilik.
BG_E_NEW_OWNER_DIFF_MAPPING
 Pemetaan drive jaringan pemilik saat ini untuk file lokal berbeda dari pemilik sebelumnya.
E_ACCESSDENIED
 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

IBackgroundCopyJob::GetOwner