Share via

IBackgroundCopyJob::TakeOwnership-Methode (bits.h)

  • Artikel

Ä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
S_OK
 Der Auftragsbesitz wurde erfolgreich geändert.
BG_E_INVALID_STATE
 Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED werden.
BG_E_NEW_OWNER_NO_FILE_ACCESS
 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.
BG_E_NEW_OWNER_DIFF_MAPPING
 Die Netzwerklaufwerkzuordnung des aktuellen Besitzers für die lokale Datei unterscheidet sich von der des vorherigen Besitzers.
E_ACCESSDENIED
 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

Weitere Informationen

IBackgroundCopyJob::GetOwner