IBitsTokenOptions::GetHelperTokenSid-Methode (bits4_0.h)
Gibt die SID des Hilfstokens zurück, wenn eines festgelegt ist.
Syntax
HRESULT GetHelperTokenSid(
[out] LPWSTR *pSid
);
Parameter
[out] pSid
Gibt die SID zurück, die aus dem TokenInformation-Parameter der GetTokenInformation-Funktion abgerufen wird. Wenn keine SID abgerufen wird, wird dieser Parameter auf NULL festgelegt.
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 die Hilfstoken-SID mit dieser Methode abzurufen. Ab Windows 10 Version 1607 können BITS-Benutzer, die nicht administrator sind, diese Methode verwenden, um die Hilfstoken-SID für BITS-Aufträge abzurufen, 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 geändert, damit Benutzer ohne Administratorberechtigungen die Hilfstoken-SID abrufen können, solange die SID des Token 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 |