IBackgroundCopyJob::TakeOwnership-Methode (bits.h)
Ändert den Besitz des Auftrags in den aktuellen Benutzer.
Syntax
HRESULT TakeOwnership();
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Auftragsbesitz wurde erfolgreich geändert. |
|
Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED werden. |
|
Der neue Besitzer hat nicht genügend Zugriff auf die temporären Dateien auf dem Clientcomputer. BITS erstellt die temporären Dateien mithilfe der Sicherheitsberechtigungen des Besitzers. |
|
Die Netzwerklaufwerkzuordnung des aktuellen Besitzers für die lokale Datei unterscheidet sich von der des vorherigen Besitzers. |
|
Der Benutzer verfügt nicht über Administratorrechte. |
Hinweise
Um den Auftrag zu übernehmen, muss der Benutzer über Administratorrechte auf dem Client verfügen. Unter Windows Vista muss der Benutzer in einem Zustand mit erhöhten Rechten ausgeführt werden. Nachdem Sie den Besitz übernommen haben, müssen alle zukünftigen Updates für den Auftrag ausgeführt werden, während der Benutzer in einem zustand mit erhöhten Rechten ausgeführt wird. Weitere Informationen finden Sie unter Benutzer und Netzwerk Connections.
Ein Administrator muss nicht die Verantwortung für den Auftrag eines anderen Benutzers übernehmen, um seine Eigenschaften zu ändern oder dem Auftrag Dateien hinzuzufügen. In der Regel verwendet ein Administrator die TakeOwnership-Methode , wenn der Benutzer nicht über ausreichende Berechtigungen zum Abschließen des Auftrags verfügt oder wenn der Benutzer nicht angemeldet ist und der Administrator den Auftrag ausführen muss.
Nachdem sich der Besitz des Auftrags geändert hat, wird der Auftrag nur verarbeitet, wenn der neue Besitzer beim Client angemeldet ist. Rufen Sie die IBackgroundCopyJob::GetOwner-Methode auf, um die SID des neuen Besitzers abzurufen.
Wenn der Administrator den Auftrag nach der Übernahme des Besitzes abbricht , ist es möglich, dass die Dateien verwaist sind, da der Administrator keine Schreibberechtigung für die Dateien hat. Dies kann auftreten, wenn sich das lokale Dateiziel im Roamingprofil des vorherigen Benutzers befindet.
Die TakeOwnership-Methode entfernt Anmeldeinformationen, Zertifikate, benutzerdefinierte Header und Befehlszeilenbenachrichtigungen aus dem Auftrag, sofern festgelegt.
Wenn der Auftrag eine Ereignisbenachrichtigung angibt, wird der Rückruf im Kontext des Benutzers ausgeführt, der die IBackgroundCopyJob::SetNotifyInterface-Methode aufgerufen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Windows |
| Kopfzeile | bits.h |
| Bibliothek | Bits.lib |
| DLL | QmgrPrxy.dll |