Share via

IBitsTokenOptions::GetHelperTokenFlags-Methode (bits4_0.h)

  • Artikel

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