Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ändert den Besitz des Auftrags an den aktuellen Benutzer.
Syntax
HRESULT TakeOwnership();
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.
| Rückgabecode | Description |
|---|---|
|
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 den vorherigen Besitzern. |
|
Der Benutzer verfügt nicht über Administratorrechte. |
Bemerkungen
Um den Besitz des Auftrags 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. Nach dem Übernehmen des Besitzes müssen alle zukünftigen Aktualisierungen des Auftrags ausgeführt werden, während der Benutzer in einem Zustand mit erhöhten Rechten ausgeführt wird. Weitere Informationen finden Sie unter "Benutzer und Netzwerkverbindungen".
Ein Administrator muss nicht den Besitz des Auftrags 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 abschließen muss.
Nachdem der Besitz des Auftrags geändert wurde, 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 dem Übernehmen des Besitzes abbricht , ist es möglich, dass die Dateien verwaist sind, da der Administrator keine Schreibberechtigung für die Dateien besitzt. 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, falls festgelegt.
Wenn der Auftrag die Ereignisbenachrichtigung angibt, wird der Rückruf im Kontext des Benutzers ausgeführt, der die IBackgroundCopyJob::SetNotifyInterface-Methode aufgerufen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows XP |
| Mindestanforderungen für unterstützte Server | Windows Server 2003 |
| Zielplattform | Fenster |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |