Méthode IBackgroundCopyJob ::TakeOwnership (bits.h)

Article
08/22/2023

Change la propriété du travail à l’utilisateur actuel.

Syntaxe

HRESULT TakeOwnership();

Valeur de retour

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Code de retour	Description
S_OK	La propriété du travail a été modifiée avec succès.
BG_E_INVALID_STATE	L’état du travail ne peut pas être BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.
BG_E_NEW_OWNER_NO_FILE_ACCESS	Le nouveau propriétaire n’a pas accès aux fichiers temporaires sur l’ordinateur client. BITS crée les fichiers temporaires à l’aide des autorisations de sécurité du propriétaire.
BG_E_NEW_OWNER_DIFF_MAPPING	Le mappage de lecteur réseau du propriétaire actuel pour le fichier local est différent de celui du propriétaire précédent.
E_ACCESSDENIED	L’utilisateur ne dispose pas de privilèges d’administrateur.

Remarques

Pour prendre possession du travail, l’utilisateur doit disposer de privilèges d’administrateur sur le client. Sur Windows Vista, l’utilisateur doit s’exécuter dans un état avec élévation de privilèges. Une fois la propriété prise en charge, toutes les mises à jour futures du travail doivent être effectuées pendant que l’utilisateur s’exécute dans un état élevé. Pour plus d’informations, consultez Utilisateurs et Connections réseau.

Un administrateur n’a pas besoin de s’approprier le travail d’un autre utilisateur pour modifier ses propriétés ou ajouter des fichiers au travail. En règle générale, un administrateur utilise la méthode TakeOwnership si l’utilisateur n’a pas les autorisations suffisantes pour effectuer le travail ou si l’utilisateur n’est pas connecté et que l’administrateur a besoin de la tâche à terminer.

Une fois la propriété du travail modifiée, la tâche est traitée uniquement lorsque le nouveau propriétaire est connecté au client. Appelez la méthode IBackgroundCopyJob ::GetOwner pour récupérer le SID du nouveau propriétaire.

Si l’administrateur annule le travail après en avoir pris la propriété, il est possible que les fichiers soient orphelins, car l’administrateur n’a pas d’autorisation d’écriture sur les fichiers. Cela peut se produire si la destination du fichier local se trouve dans le profil itinérant de l’utilisateur précédent.

La méthode TakeOwnership supprime les informations d’identification, les certificats, les en-têtes personnalisés et la notification de ligne de commande du travail, si elle est définie.

Si le travail spécifie la notification d’événement, le rappel est exécuté dans le contexte de l’utilisateur qui a appelé la méthode IBackgroundCopyJob ::SetNotifyInterface .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
Plateforme cible	Windows
En-tête	bits.h
Bibliothèque	Bits.lib
DLL	QmgrPrxy.dll

Voir aussi

IBackgroundCopyJob ::GetOwner

Partager via