Méthode IBackgroundCopyJob ::TakeOwnership (bits.h)
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 |
|---|---|
|
La propriété du travail a été modifiée avec succès. |
|
L’état du travail ne peut pas être BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED. |
|
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. |
|
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. |
|
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, lescertificats, 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 |