IBitsTokenOptions::ClearHelperToken-Methode (bits4_0.h)
Verwirft das Hilfstoken und ändert die Verwendungsflags nicht.
Syntax
HRESULT ClearHelperToken();
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Ältere Implementierungen erforderten effektiv, dass BITS-Benutzer über Administratorrechte verfügen, um ein Hilfstoken mit dieser Methode zu löschen. Ab Windows 10 Version 1607 können BITS-Benutzer ohne Administratorrechte diese Methode verwenden, um Hilfstoken für BITS-Aufträge zu löschen, die sie besitzen. Durch diese Änderung können BITS-Benutzer ohne Administratorrechte (z. B. Hintergrunddownloaderdienste, die unter dem NetworkService-Konto ausgeführt werden) Hilfstoken effektiv verwenden.
Insbesondere wurde die Implementierung so geändert, dass Benutzer ohne Administratorrechte ein Hilfstoken löschen können, solange die SID des Threadtokens des Aufrufers mit der SID des Benutzerkontos des Auftragsbesitzers während des IBackgroundCopyJob::QueryInterface-Aufrufs identisch ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | bits4_0.h |
| Verteilbare Komponente | Windows Management Framework unter Windows Vista mit SP1, Windows Vista mit SP2 und Windows Server 2008 mit SP2 |