IBackgroundCopyJobHttpOptions::SetSecurityFlags-Methode (bits2_5.h)
Legt Flags für HTTP fest, die bestimmen, ob die Zertifikatsperrliste überprüft und bestimmte Zertifikatfehler ignoriert werden, sowie die Richtlinie, die verwendet werden soll, wenn ein Server die HTTP-Anforderung umleitet.
Syntax
HRESULT SetSecurityFlags(
[in] ULONG Flags
);
Parameter
[in] Flags
HTTP-Sicherheitsflags, die angeben, welche Fehler beim Herstellen einer Verbindung mit dem Server ignoriert werden sollen. Sie können mindestens eins der folgenden Flags festlegen:
Rückgabewert
In der folgenden Tabelle sind einige der möglichen Rückgabewerte aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Header wurden erfolgreich abgerufen. |
|
Der Flagwert wird nicht unterstützt. |
Hinweise
Wenn die CRL-Überprüfung angefordert wird, führt BITS die Überprüfung für alle Dateien im Auftrag durch, die das HTTPS-Protokoll angeben. Die Überprüfung erfolgt für jede Datei, bevor die Datei mit der Übertragung beginnt. Wenn Sie diesen Wert auf TRUE festlegen, nachdem BITS eine Datei teilweise heruntergeladen hat, plant BITS den Auftrag neu und beginnt erneut mit dem Herunterladen der Datei. Dateien, die bereits heruntergeladen wurden, sind nicht betroffen.
BITS verwendet die Zertifikatsperrliste auf dem lokalen Computer, wenn die Zertifikatsperrliste auf dem neuesten Stand ist. Andernfalls lädt BITS die Zertifikatsperrliste von der Zertifizierungsstelle herunter, die das Zertifikat signiert hat.
Der Auftrag wechselt in den Status schwerwiegender Fehler, wenn die folgenden Fehler auftreten.
| Fehlercode | BESCHREIBUNG |
|---|---|
| ERROR_WINHTTP_SECURE_CERT_REV_FAILED | Die Überprüfung der Zertifikatsperrliste kann nicht angefordert werden, da der Zertifikatserver offline ist oder die Zertifikatsperrliste nicht heruntergeladen werden kann. |
| ERROR_WINHTTP_SECURE_CERT_REVOKED | Das Zertifikat wurde widerrufen. |
Die Umleitungsrichtlinie gilt für alle Dateien in einem Downloadauftrag (die Richtlinie gilt nicht für Uploadaufträge).
Vor BITS 3.0: Die Umleitungsrichtlinien werden nicht unterstützt.
Wenn die Richtlinie BG_HTTP_REDIRECT_POLICY_DISALLOW ist und der Server Ihre Anforderung umleitet, wird der Auftrag mit einem der folgenden Fehlercodes in den Status schwerwiegender Fehler versetzt. Beschreibungen der Fehlercodes finden Sie unter HTTP-Statuscodes.
- HRESULT_FROM_WIN32(HTTP_STATUS_AMBIGUOUS)
- HRESULT_FROM_WIN32(HTTP_STATUS_MOVED)
- HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT)
- HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT_METHOD)
- HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT_KEEP_VERB)
Wenn die Peerzwischenspeicherung aktiviert ist und Sie BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT angeben, wird die Datei mit der endgültigen umgeleiteten URL im Cache gespeichert. Wenn ein Peer dann versucht, die Datei mit der ursprünglichen URL herunterzuladen, findet der Peer die Datei nicht im Cache des Peers und lädt die Datei am Ende vom Ursprungsserver herunter.
Wenn Sie angeben und die Datei aus dem
Beachten Sie, dass das Festlegen BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT das Ergebnis beim Aufrufen der IBackgroundCopyJob3::ReplaceRemotePrefix-Methode beeinflussen kann. Wenn ein Server Ihre Anforderung umgeleitet hat, hat BITS die ursprüngliche URL bereits in die endgültige umgeleitete URL geändert, sodass beim Aufrufen der ReplaceRemotePrefix-Methode keine Dateien mit der ursprünglichen URL gefunden werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | bits2_5.h (Bits.h einschließen) |
| Bibliothek | Bits.lib |