Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Modifie la propriété du travail à l’utilisateur actuel.
Syntaxe
HRESULT TakeOwnership();
Valeur retournée
Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.
| Code de retour | Descriptif |
|---|---|
|
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 n’a 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 élevé. Après avoir pris possession, toutes les futures mises à jour du travail doivent être effectuées pendant que l’utilisateur est en cours d’exécution dans un état élevé. Pour plus d’informations, consultez Utilisateurs et connexions réseau.
Un administrateur n’a pas besoin de prendre possession du 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 l’autorisation suffisante pour terminer le travail ou si l’utilisateur n’est pas connecté et que l’administrateur a besoin de la tâche.
Une fois la propriété du travail modifiée, le travail est traité 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 avoir pris possession, il est possible que les fichiers soient orphelins , car l’administrateur n’a pas l’autorisation d’écriture dans 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 .
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum requis | Windows XP |
| Serveur minimal pris en charge | Windows Server 2003 |
| plateforme cible | Fenêtres |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |