IBitsTokenOptions::GetHelperTokenFlags-Methode (bits4_0.h)

Gibt die Verwendungsflags für ein Token zurück, das einem BITS-Übertragungsauftrag zugeordnet ist.

Syntax

HRESULT GetHelperTokenFlags(
  [out] DWORD *pFlags
);

Parameter

[out] pFlags

Gibt das zurückzugebende Verwendungsflag an. Dieser Parameter muss auf einen der folgenden Werte festgelegt werden:

Wert	Bedeutung
BG_TOKEN_LOCAL_FILE 0x0001	Wenn dieses Flag angegeben ist, wird das Hilfstoken verwendet. So öffnen Sie die lokale Datei eines Uploadauftrags So erstellen oder benennen Sie die temporäre Datei eines Downloadauftrags um So erstellen oder benennen Sie die Antwortdatei eines Upload-Antwortauftrags um
BG_TOKEN_NETWORK 0x0002	Wenn dieses Flag angegeben ist, wird das Hilfstoken verwendet. So öffnen Sie die Remotedatei eines SMB-Upload- oder -Downloadauftrags (Server Message Block) Als Reaktion auf eine HTTP-Server- oder Proxyanforderung für implizite NTLM- oder Kerberos-Anmeldeinformationen Eine Anwendung muss die IBackgroundCopyJob2::SetCredentials-Methode aufrufen, damit die Anmeldeinformationen über HTTP gesendet werden können.

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 Hilfstokenflags mit dieser Methode abzurufen. Ab Windows 10 Version 1607 können BITS-Benutzer ohne Administratorrechte diese Methode verwenden, um Hilfstokenverwendungsflags 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 so geändert, dass Benutzer ohne Administratorrechte Hilfstokenflags abrufen können, solange die SID des Threadtokens des Aufrufenden 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