IBitsTokenOptions::GetHelperTokenSid-Methode (bits4_0.h)

Gibt die SID des Hilfstokens zurück, wenn eines festgelegt ist.

Hinweis Diese Methode gibt das Token nicht zurück.

 

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

Weitere Informationen

IBitsTokenOptions