Optionsflags (Wininet.h)

Die folgenden Optionsflags werden mit den Funktionen InternetQueryOption und InternetSetOption verwendet. Alle gültigen Optionsflags haben einen Wert größer oder gleich INTERNET_FIRST_OPTION und kleiner als oder gleich INTERNET_LAST_OPTION.

INTERNET_OPTION_ALTER_IDENTITY

80

Nicht implementiert

INTERNET_OPTION_ASYNC

30

Nicht implementiert.

INTERNET_OPTION_ASYNC_ID

15

Nicht implementiert.

INTERNET_OPTION_ASYNC_PRIORITY

16

Nicht implementiert.

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64

Legt den booleschen Wert fest, der bestimmt, ob das System das Netzwerk auf neuere Inhalte überprüfen soll, und überschreibt bearbeitete Cacheeinträge, wenn eine neuere Version gefunden wird. Wenn auf True festgelegt ist, überprüft das System das Netzwerk auf neuere Inhalte und überschreibt den bearbeiteten Cacheeintrag mit der neueren Version. Der Standardwert ist False, was angibt, dass der bearbeitete Cacheeintrag verwendet werden soll, ohne das Netzwerk zu überprüfen. Dies wird von InternetQueryOption und InternetSetOption verwendet. Sie ist nur in Microsoft Internet Explorer 5 und höher gültig.

INTERNET_OPTION_CACHE_STREAM_HANDLE

27

Wird nicht mehr unterstützt.

INTERNET_OPTION_CACHE_TIMESTAMPS

69

Ruft eine INTERNET_CACHE_TIMESTAMPS-Struktur ab, die die LastModified-Zeit und die Ablaufzeit von der im Internetcache gespeicherten Ressource enthält. Dieser Wert wird von InternetQueryOption verwendet.

INTERNET_OPTION_CALLBACK

1

Legt die Adresse der für dieses Handle definierten Rückruffunktion fest oder ruft sie ab. Diese Option kann für alle HINTERNET-Handles verwendet werden. Wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_CALLBACK_FILTER

54

Nicht implementiert.

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84

Dieses Flag wird von InternetQueryOption nicht unterstützt. Der lpBuffer-Parameter muss ein Zeiger auf eine CERT_CONTEXT-Struktur und kein Zeiger auf einen CERT_CONTEXT-Zeiger sein. Wenn eine Anwendung ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED empfängt, muss sie InternetErrorDlg aufrufen oder InternetSetOption verwenden, um ein Zertifikat bereitzustellen, bevor die Anforderung erneut durchgeführt wird. CertDuplicateCertificateContext wird dann aufgerufen, sodass der übergebene Zertifikatkontext von der Anwendung unabhängig freigegeben werden kann.

INTERNET_OPTION_CODEPAGE

68

Standardmäßig wird der Host- oder Autoritätsteil der Unicode-URL gemäß der IDN-Spezifikation codiert. Wenn Sie diese Option für die Anforderung oder das Verbindungshandle festlegen, wenn IDN deaktiviert ist, wird ein Codepagecodierungsschema für den Hostteil der URL angegeben. Der lpBuffer-Parameter im Aufruf von InternetSetOption enthält die gewünschte DBCS-Codepage. Wenn in lpBuffer keine Codepage angegeben ist, verwendet WinINet die Standardcodepage des Systems (CP_ACP). Hinweis: Diese Option wird ignoriert, wenn IDN nicht deaktiviert ist. Weitere Informationen zum Deaktivieren von IDN finden Sie in der Option INTERNET_OPTION_IDN .

Windows XP mit SP2 und Windows Server 2003 mit SP1: Dieses Flag wird nicht unterstützt.

Version: Erfordert Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_PATH

100

Standardmäßig ist der Pfadteil der URL UTF8-codiert. Die WinINet-API führt die Escapezeichencodierung (%) für die Hochbitzeichen aus. Durch Festlegen dieser Option für die Anforderung oder das Verbindungshandle wird die UTF8-Codierung deaktiviert und eine bestimmte Codepage festgelegt. Der lpBuffer-Parameter im Aufruf von InternetSetOption enthält die gewünschte DBCS-Codepage für den Pfad. Wenn in lpBuffer keine Codepage angegeben ist, verwendet WinINet die Standard-CP_UTF8.

Windows XP mit SP2 und Windows Server 2003 mit SP1: Dieses Flag wird nicht unterstützt.

Version: Erfordert Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_EXTRA

101

Standardmäßig ist der Pfadteil der URL die Standardcodepage des Systems (CP_ACP). Die Escapezeichenkonvertierungen (%) werden für den zusätzlichen Teil nicht ausgeführt. Wenn Sie diese Option für die Anforderung oder das Verbindungshandle festlegen, wird die CP_ACP-Codierung deaktiviert. Der lpBuffer-Parameter im Aufruf von InternetSetOption enthält die gewünschte DBCS-Codepage für den zusätzlichen Teil der URL. Wenn in lpBuffer keine Codepage angegeben ist, verwendet WinINet die Standardcodepage des Systems (CP_ACP).

Windows XP mit SP2 und Windows Server 2003 mit SP1: Dieses Flag wird nicht unterstützt.

Version: Erfordert Internet Explorer 7.0.

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147

Für eine Anforderung, bei der WinInet die vom Server angegebene Inhaltscodierung dekomprimiert hat, ruft die vom Server gemeldete Inhaltslänge des Antworttexts als ULONGLONGLONG ab. Unterstützt in Windows 10, Version 1507 und höher.

INTERNET_OPTION_CONNECT_BACKOFF

4

Nicht implementiert.

INTERNET_OPTION_CONNECT_RETRIES

3

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der die Anzahl der Versuche von WinINet enthält, einen Host aufzulösen und eine Verbindung mit diesem herzustellen, oder ruft diesen ab. Es wird nur einmal pro IP-Adresse versucht. Wenn Sie beispielsweise versuchen, eine Verbindung mit einem Multihomehost herzustellen, der über zehn IP-Adressen verfügt und INTERNET_OPTION_CONNECT_RETRIES auf sieben festgelegt ist, versucht WinINet nur, die ersten sieben IP-Adressen aufzulösen und eine Verbindung mit ihnen herzustellen. Umgekehrt versucht WinINet bei demselben Satz von zehn IP-Adressen, wenn INTERNET_OPTION_CONNECT_RETRIES auf 20 festgelegt ist, jede der zehn nur einmal. Wenn ein Host nur über eine IP-Adresse verfügt und der erste Verbindungsversuch fehlschlägt, gibt es keine weiteren Versuche. Wenn ein Verbindungsversuch nach der angegebenen Anzahl von Versuchen weiterhin fehlschlägt, wird die Anforderung abgebrochen. Der Standardwert für INTERNET_OPTION_CONNECT_RETRIES beträgt fünf Versuche. Diese Option kann für jedes HINTERNET-Handle verwendet werden, einschließlich eines NULL-Handles . Sie wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_CONNECT_TIME

55

Nicht implementiert.

INTERNET_OPTION_CONNECT_TIMEOUT

2

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der den Timeoutwert in Millisekunden enthält, der für Internetverbindungsanforderungen verwendet werden soll, oder ruft diesen ab. Wenn Sie diese Option auf unendlich (0xFFFFFFFF) festlegen, wird dieser Timer deaktiviert.

Wenn eine Verbindungsanforderung länger als dieser Timeoutwert dauert, wird die Anforderung abgebrochen. Beim Versuch, eine Verbindung mit mehreren IP-Adressen für einen einzelnen Host (einen Host mit mehreren Adressen) herzustellen, ist das Timeoutlimit für alle IP-Adressen kumulativ. Diese Option kann für jedes HINTERNET-Handle verwendet werden, einschließlich eines NULL-Handles . Sie wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_CONNECTED_STATE

50

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der den verbundenen Zustand enthält, oder ruft diesen ab. Dies wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_CONTEXT_VALUE

45

Legt einen DWORD_PTR fest, der die Adresse des Diesem HINTERNET-Handle zugeordneten Kontextwerts enthält, oder ruft diesen ab. Diese Option kann für jedes HINTERNET-Handle verwendet werden. Dies wird von InternetQueryOption und InternetSetOption verwendet. Zuvor wurde der Kontextwert auf die adresse festgelegt, die im zeiger lpBuffer gespeichert ist. Dies wurde korrigiert, sodass der im Puffer gespeicherte Wert verwendet wird und dem flag INTERNET_OPTION_CONTEXT_VALUE ein neuer Wert zugewiesen wird. Der alte Wert 10 wurde beibehalten, sodass anwendungen, die für das alte Verhalten geschrieben wurden, weiterhin unterstützt werden.

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

Identisch mit INTERNET_OPTION_RECEIVE_TIMEOUT. Dies wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

Identisch mit INTERNET_OPTION_SEND_TIMEOUT. Dies wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

Legt einen wert ohne Vorzeichen mit langer Ganzzahl fest, der den Timeoutwert in Millisekunden enthält, um eine Antwort auf eine Anforderung für den Datenkanal einer FTP-Transaktion zu empfangen, oder ruft diesen ab. Dauert die Antwort länger als dieser Timeout-Wert, wird die Anforderung abgebrochen. Diese Option kann für jedes HINTERNET-Handle verwendet werden, einschließlich eines NULL-Handles . Sie wird von InternetQueryOption und InternetSetOption verwendet.

Dieses Flag hat keine Auswirkungen auf die HTTP-Funktionalität.

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

Legt einen wert ohne Vorzeichen (long integer) in Millisekunden fest, der den Timeoutwert zum Senden einer Anforderung für den Datenkanal einer FTP-Transaktion enthält, oder ruft diesen ab. Wenn der Sendevorgang länger dauert als dieser Timeoutwert, wird der Sendevorgang abgebrochen. Diese Option kann für jedes HINTERNET-Handle verwendet werden, einschließlich eines NULL-Handles . Sie wird von InternetQueryOption und InternetSetOption verwendet.

Dieses Flag hat keine Auswirkungen auf die HTTP-Funktionalität.

INTERNET_OPTION_DATAFILE_NAME

33

Ruft einen Zeichenfolgenwert ab, der den Namen der Datei enthält, die eine heruntergeladene Entität sichert. Dieses Flag ist gültig, nachdem InternetOpenUrl, FtpOpenFile, GopherOpenFile oder HttpOpenRequest abgeschlossen wurde. Diese Option kann nur von InternetQueryOption abgefragt werden.

INTERNET_OPTION_DATAFILE_EXT

96

Legt einen Zeichenfolgenwert fest, der die Erweiterung der Datei enthält, die eine heruntergeladene Entität sichert. Dieses Flag sollte vor dem Aufrufen von InternetOpenUrl, FtpOpenFile, GopherOpenFile oder HttpOpenRequest festgelegt werden. Diese Option kann nur von InternetSetOption festgelegt werden.

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67

Ruft eine INTERNET_DIAGNOSTIC_SOCKET_INFO-Struktur ab, die Daten zu einer angegebenen HTTP-Anforderung enthält. Dieses Flag wird von InternetQueryOption verwendet.

Windows 7: Diese Option wird nicht mehr unterstützt.

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76

Bewirkt, dass sich das System vom SSPI-Paket für die Digestauthentifizierung abmeldet und alle für den Prozess erstellten Anmeldeinformationen löscht. Für diese Option ist kein Puffer erforderlich. Sie wird von InternetSetOption verwendet.

INTERNET_OPTION_DISABLE_AUTODIAL

70

Nicht implementiert.

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49

Nicht implementiert.

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148

Legt eine DWORD-Bitmaske für akzeptable erweiterte HTTP-Versionen fest. Kann für jeden Handle-Typ festgelegt werden. Mögliche Werte:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Unterstützt unter Windows 10 Version 1507 und höher.

Legacyversionen von HTTP (1.1 und früher) können mit dieser Option nicht deaktiviert werden. Der Standardwert ist 0x0. Unterstützt in Windows 10, Version 1507 und höher.

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122

Legt für ein Anforderungshandle einen booleschen Wert fest, der steuert, ob Umleitungen aus dem WinInet-Cache für eine bestimmte Anforderung zurückgegeben werden. Der Standardwert lautet FALSE. Unterstützt in Windows 8 und höher.

INTERNET_OPTION_ENCODE_EXTRA

155

Ruft einen BOOL-Wert ab, der angibt, ob Nicht-ASCII-Zeichen in der Abfragezeichenfolge prozentual codiert werden sollen. Der Standardwert lautet FALSE. Unterstützt in Windows 8.1 und höher.

INTERNET_OPTION_END_BROWSER_SESSION

42

Leert einträge, die nicht aus dem Kennwortcache auf der Festplatte verwendet werden. Setzt auch die Cachezeit zurück, die verwendet wird, wenn der Synchronisierungsmodus einmal pro Sitzung ist. Für diese Option ist kein Puffer erforderlich. Dies wird von InternetSetOption verwendet.

INTERNET_OPTION_ERROR_MASK

62

Legt einen wert ohne Vorzeichen mit langer Ganzzahl fest, der die Fehlermasken enthält, die von der Clientanwendung behandelt werden können. Dies kann eine Kombination der folgenden Werte sein:

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

Gibt an, dass alle Zertifikatfehler mit der gleichen Fehlerrückgabe gemeldet werden sollen, nämlich ERROR_INTERNET_SEC_CERT_ERRORS. Wenn dieses Flag festgelegt ist, rufen Sie InternetErrorDlg auf, wenn sie den ERROR_INTERNET_SEC_CERT_ERRORS-Fehler erhalten, damit der Benutzer auf ein vertrautes Dialogfeld reagieren kann, in dem das Problem beschrieben wird.

Achtung

Wenn der Benutzer nicht über diesen Fehler informiert wird, wird der Benutzer potenziellen Spoofingangriffen ausgesetzt.

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

Gibt an, dass die Clientanwendung den ERROR_INTERNET_INSERT_CDROM Fehlercode verarbeiten kann.

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

Gibt an, dass die Clientanwendung den ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY Fehlercode verarbeiten kann.

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

Nicht implementiert.

INTERNET_OPTION_ENTERPRISE_CONTEXT

159

Legt einen PWSTR fest, der die Enterprise-ID (siehe https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx) enthält, die für die Anforderung gilt. Unterstützt in Windows 10, Version 1507 und höher.

INTERNET_OPTION_EXTENDED_ERROR

24

Ruft einen wert ohne Vorzeichen mit langer Ganzzahl ab, der einen Winsock-Fehlercode enthält, der dem ERROR_INTERNET_ Fehlermeldungen zugeordnet ist , die zuletzt in diesem Threadkontext zurückgegeben wurden. Diese Option wird für ein NULLHINTERNET-Handle von InternetQueryOption verwendet.

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

Legt einen wert ohne Vorzeichen fest, der die Zeitspanne enthält, die das System auf eine Antwort auf eine Netzwerkanforderung warten soll, bevor der Cache auf eine Kopie der Ressource überprüft wird, oder ruft diesen wert ab. Wenn eine Netzwerkanforderung länger dauert als die angegebene Zeit und die angeforderte Ressource im Cache verfügbar ist, wird die Ressource aus dem Cache abgerufen. Dies wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_HANDLE_TYPE

9

Ruft einen long-integer-Wert ohne Vorzeichen ab, der den Typ der übergebenen HINTERNET-Handles enthält. Dies wird von InternetQueryOption für ein beliebiges HINTERNET-Handle verwendet. Folgende Rückgabewerte sind möglich.

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157

Ruft einen BOOL ab, der angibt, ob WinInet http Strict Transport Security (HSTS)-Anweisungen von Servern befolgen soll. Wenn diese Option aktiviert ist, werden https:// schematierten Anforderungen an Domänen mit einer von WinInet zwischengespeicherten HSTS-Richtlinie an übereinstimmende https:// URLs umgeleitet. Der Standardwert lautet FALSE. Unterstützt in Windows 8.1 und höher.

INTERNET_OPTION_HTTP_DECODING

65

Ermöglicht WinINet das Ausführen der Decodierung für die gzip- und deflate-Codierungsschemas. Weitere Informationen finden Sie unter Inhaltscodierung.

INTERNET_OPTION_HTTP_PROTOCOL_USED

149

Ruft ein DWORD ab, das angibt, welche erweiterte HTTP-Version für eine bestimmte Anforderung verwendet wurde. Mögliche Werte:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Unterstützt unter Windows 10 Version 1507 und höher.

0x0 gibt HTTP/1.1 oder früher an; Weitere Informationen finden Sie unter INTERNET_OPTION_HTTP_VERSION, wenn eine höhere Genauigkeit hinsichtlich der verwendeten Legacyversion erforderlich ist. Unterstützt unter Windows 10 Version 1507 und höher.

INTERNET_OPTION_HTTP_VERSION

59

Legt eine HTTP_VERSION_INFO-Struktur fest, die die unterstützte HTTP-Version enthält, oder ruft sie ab. Dies muss für ein NULL-Handle verwendet werden. Dies wird von InternetQueryOption und InternetSetOption verwendet.

Unter Windows 7, Windows Server 2008 R2 und höher wird der Wert des dwMinorVersion-Elements in der HTTP_VERSION_INFO-Struktur von internet-Explorer-Einstellungen überschrieben. EnableHttp1_1 ist ein Registrierungswert unter HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE, der von Internetoptionen gesteuert wird, die im Internet Explorer für das System festgelegt ist. Der EnableHttp1_1 Wert ist standardmäßig 1. Die HTTP_VERSION_INFO-Struktur wird für alle HTTP-Versionen unter 1.1 ignoriert, wenn EnableHttp1_1 auf 1 festgelegt ist.

INTERNET_OPTION_IDENTITY

78

Nicht implementiert.

INTERNET_OPTION_IDLE_STATE

51

Nicht implementiert.

INTERNET_OPTION_IDN

102

Standardmäßig wird der Host- oder Autoritätsteil der URL gemäß der IDN-Spezifikation für direkte und Proxyverbindungen codiert. Diese Option kann für die Anforderung oder das Verbindungshandle verwendet werden, um IDN zu aktivieren oder zu deaktivieren. Wenn IDN deaktiviert ist, verwendet WinINet die Systemcodepage, um den Host- oder Autoritätsteil der URL zu codieren. Um die IDN-Hostkonvertierung zu deaktivieren, legen Sie den lpBuffer-Parameter im Aufruf von InternetSetOption auf null fest. Um die IDN-Konvertierung nur für die direkte Verbindung zu aktivieren, geben Sie INTERNET_FLAG_IDN_DIRECT im lpBuffer-Parameter im Aufruf von InternetSetOption an. Um die IDN-Konvertierung nur für die Proxyverbindung zu aktivieren, geben Sie im Parameter lpBuffer im Aufruf von InternetSetOptionINTERNET_FLAG_IDN_PROXY an.

Windows XP mit SP2 und Windows Server 2003 mit SP1: Dieses Flag wird nicht unterstützt.

Version: Erfordert Internet Explorer 7.0.

INTERNET_OPTION_IGNORE_OFFLINE

77

Legt fest, ob das globale Offlineflag für das angegebene Anforderungshandle ignoriert werden soll, oder ruft es ab. Für diese Option ist kein Puffer erforderlich. Dies wird von InternetQueryOption und InternetSetOption mit einem Anforderungshandle verwendet. Diese Option ist nur im Internet Explorer 5 und höher gültig.

INTERNET_OPTION_KEEP_CONNECTION

22

Nicht implementiert.

INTERNET_OPTION_LISTEN_TIMEOUT

11

Nicht implementiert.

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der die maximal zulässige Anzahl von Verbindungen pro HTTP/1.0-Server enthält, oder ruft diesen ab. Dies wird von InternetQueryOption und InternetSetOption verwendet. Diese Option ist nur im Internet Explorer 5 und höher gültig.

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der die maximale Anzahl von Verbindungen enthält, die pro CERN-Proxy zulässig sind, oder ruft diesen ab. Wenn diese Option festgelegt oder abgerufen wird, muss der hInternet-Parameter auf einen NULL-Handle-Wert festgelegt werden. Ein NULL-Handle-Wert gibt an, dass die Option für den aktuellen Prozess festgelegt oder abgefragt werden soll. Beim Aufrufen von InternetSetOption mit dieser Option erhalten alle vorhandenen Proxyobjekte den neuen Wert. Dieser Wert ist auf einen Bereich von einschließlich 2 bis 128 beschränkt.

Version: Erfordert Internet Explorer 8.0.

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der die maximal zulässige Anzahl von Verbindungen pro Server enthält, oder ruft diesen ab. Dies wird von InternetQueryOption und InternetSetOption verwendet. Diese Option ist nur im Internet Explorer 5 und höher gültig.

INTERNET_OPTION_OFFLINE_MODE

26

Nicht implementiert.

INTERNET_OPTION_OFFLINE_SEMANTICS

52

Nicht implementiert.

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176

Melden Sie sich für schwache Signaturen (z. B. SHA-1) an, die als unsicher behandelt werden sollen. Dadurch wird WinInet angewiesen , CertGetCertificateChain mithilfe des CERT_CHAIN_OPT_IN_WEAK_SIGNATURE-Parameters aufzurufen.

INTERNET_OPTION_PARENT_HANDLE

21

Ruft das übergeordnete Handle für dieses Handle ab. Diese Option kann für ein beliebiges HINTERNET-Handle von InternetQueryOption verwendet werden.

INTERNET_OPTION_PASSWORD

29

Legt einen Zeichenfolgenwert fest, der das Kennwort enthält, das einem von InternetConnect zurückgegebenen Handle zugeordnet ist, oder ruft diesen ab. Dies wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_PER_CONNECTION_OPTION

75

Legt eine INTERNET_PER_CONN_OPTION_LIST-Struktur fest oder ruft sie ab, die eine Liste von Optionen für eine bestimmte Verbindung angibt. Dies wird von InternetQueryOption und InternetSetOption verwendet. Diese Option ist nur im Internet Explorer 5 und höher gültig.

Hinweis

INTERNET_OPTION_PER_CONNECTION_OPTION bewirkt, dass die Einstellungen systemweit geändert werden, wenn beim Aufruf von InternetSetOption ein NULL-Handle verwendet wird. Zum Aktualisieren der globalen Proxyeinstellungen müssen Sie InternetSetOption mit dem Optionsflag INTERNET_OPTION_REFRESH aufrufen.

Hinweis

Um Proxyinformationen für den gesamten Prozess zu ändern, ohne die globalen Einstellungen in Internet Explorer 5 und höher zu beeinflussen, verwenden Sie diese Option für das Handle, das von InternetOpen zurückgegeben wird. Im folgenden Codebeispiel wird der Proxy für den gesamten Prozess geändert, obwohl das HINTERNET-Handle geschlossen ist und von keiner Anforderung verwendet wird.

INTERNET_OPTION_POLICY

48

Nicht implementiert.

INTERNET_OPTION_PROXY

38

Legt eine INTERNET_PROXY_INFO-Struktur fest, die die Proxydaten für ein vorhandenes InternetOpen-Handle enthält, wenn das HINTERNET-Handle nicht NULL ist, oder ruft sie ab. Wenn das HINTERNET-HandleNULL ist, legt die Funktion die globalen Proxydaten fest oder fragt sie ab. Diese Option kann für den von InternetOpen zurückgegebenen Handle verwendet werden. Sie wird von InternetQueryOption und InternetSetOption verwendet.

Hinweis

Es wird empfohlen, anstelle von INTERNET_OPTION_PROXY INTERNET_OPTION_PER_CONNECTION_OPTION zu verwenden.

INTERNET_OPTION_PROXY_PASSWORD

44

Legt einen Zeichenfolgenwert fest, der das Kennwort enthält, das für den Zugriff auf den Proxy verwendet wird, oder ruft diesen ab. Dies wird von InternetQueryOption und InternetSetOption verwendet. Diese Option kann für das von InternetConnect oder HttpOpenRequest zurückgegebene Handle festgelegt werden.

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

Benachrichtigt den aktuellen WinInet-instance, dass sich die Proxyeinstellungen geändert haben und dass sie mit den neuen Einstellungen aktualisiert werden müssen. Um alle verfügbaren WinInet-Instanzen zu warnen, legen Sie beim Übergeben dieser Option den Pufferparameter von InternetSetOption auf NULL und BufferLength auf 0 fest. Diese Option kann für das von InternetConnect oder HttpOpenRequest zurückgegebene Handle festgelegt werden.

INTERNET_OPTION_PROXY_USERNAME

43

Legt einen Zeichenfolgenwert fest, der den Benutzernamen enthält, der für den Zugriff auf den Proxy verwendet wird, oder ruft diesen ab. Dies wird von InternetQueryOption und InternetSetOption verwendet. Diese Option kann für das von InternetConnect oder HttpOpenRequest zurückgegebene Handle festgelegt werden.

INTERNET_OPTION_READ_BUFFER_SIZE

12

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der die Größe des Lesepuffers enthält, oder ruft diesen ab. Diese Option kann für HINTERNET-Handles verwendet werden, die von FtpOpenFile, FtpFindFirstFile und InternetConnect zurückgegeben werden (nur FTP-Sitzung). Diese Option wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

Nicht implementiert.

INTERNET_OPTION_RECEIVE_TIMEOUT

6

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der den Timeoutwert in Millisekunden enthält, um eine Antwort auf eine Anforderung zu empfangen, oder ruft diesen ab. Dauert die Antwort länger als dieser Timeout-Wert, wird die Anforderung abgebrochen. Diese Option kann für jedes HINTERNET-Handle verwendet werden, einschließlich eines NULL-Handles . Sie wird von InternetQueryOption und InternetSetOption verwendet.

Diese Option soll kein präzises, sofortiges Timeout darstellen. Sie können davon ausgehen, dass das Timeout bis zu sechs Sekunden nach dem festgelegten Timeoutwert auftritt.

Bei Verwendung als Verweis auf eine FTP-Transaktion bezieht sich diese Option auf den Steuerungskanal.

INTERNET_OPTION_REFRESH

37

Bewirkt, dass die Proxydaten aus der Registrierung für ein Handle erneut gelesen werden. Es ist kein Puffer erforderlich. Diese Option kann für das von InternetOpen zurückgegebene HINTERNET-Handle verwendet werden. Sie wird von InternetSetOption verwendet.

INTERNET_OPTION_REMOVE_IDENTITY

79

Nicht implementiert.

INTERNET_OPTION_REQUEST_FLAGS

23

Ruft einen ganzzahligen Wert ohne Vorzeichen ab, der die speziellen status-Flags enthält, die die status des laufenden Downloads angeben. Dies wird von InternetQueryOption verwendet. Die Option INTERNET_OPTION_REQUEST_FLAGS kann einen der folgenden Werte aufweisen:

INTERNET_REQFLAG_ASYNC

0x00000002

Nicht implementiert.

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

Internetanforderungen können nicht zwischengespeichert werden (z. B. eine HTTPS-Anforderung).

INTERNET_REQFLAG_FROM_CACHE

0x00000001

Die Antwort kam aus dem Cache.

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

Timeout der Internetanforderung.

INTERNET_REQFLAG_NO_HEADERS

0x00000008

Die ursprüngliche Antwort enthielt keine Header.

INTERNET_REQFLAG_PASSIVE

0x00000010

Nicht implementiert.

INTERNET_REQFLAG_VIA_PROXY

0x00000004

Die Anforderung wurde über einen Proxy gestellt.

INTERNET_OPTION_REQUEST_PRIORITY

58

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der die Priorität von Anforderungen enthält, die für eine Verbindung mit einem HTTP-Handle konkurrieren, oder ruft diesen ab. Dies wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

Startet eine neue Cachesitzung für den Prozess. Es ist kein Puffer erforderlich. Dies wird von InternetSetOption verwendet. Diese Option ist nur für die interne Verwendung reserviert.

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

Legt einen Zeichenfolgenwert fest, der den sekundären Cacheschlüssel enthält, oder ruft diesen ab. Dies wird von InternetQueryOption und InternetSetOption verwendet. Diese Option ist nur für die interne Verwendung reserviert.

INTERNET_OPTION_SECURITY_CERTIFICATE

35

Ruft das Zertifikat für einen SSL/PCT-Server (Secure Sockets Layer/Private Communications Technology) in einer formatierten Zeichenfolge ab. Dies wird von InternetQueryOption verwendet.

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32

Ruft das Zertifikat für einen SSL-/PCT-Server in die INTERNET_CERTIFICATE_INFO-Struktur ab. Dies wird von InternetQueryOption verwendet.

INTERNET_OPTION_SECURITY_FLAGS

31

Ruft einen ganzzahligen Wert ohne Vorzeichen ab, der die Sicherheitsflags für ein Handle enthält. Diese Option wird von InternetQueryOption verwendet. Dies kann eine Kombination der folgenden Werte sein.

SECURITY_FLAG_128BIT

0x20000000

Identisch mit dem bevorzugten Wert SECURITY_FLAG_STRENGTH_STRONG. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

SECURITY_FLAG_40BIT

0x10000000

Identisch mit dem bevorzugten Wert SECURITY_FLAG_STRENGTH_WEAK. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

SECURITY_FLAG_56BIT

0x40000000

Identisch mit dem bevorzugten Wert SECURITY_FLAG_STRENGTH_MEDIUM. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

SECURITY_FLAG_FORTEZZA

0x08000000

Gibt an, dass Fortezza verwendet wurde, um Vertraulichkeit, Authentifizierung und/oder Integrität für die angegebene Verbindung bereitzustellen.

SECURITY_FLAG_IETFSSL4

0x00000020

Nicht implementiert.

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Ignoriert die Fehlermeldung ERROR_INTERNET_SEC_CERT_CN_INVALID .

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Ignoriert die fehlermeldung ERROR_INTERNET_SEC_CERT_DATE_INVALID .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Ignoriert die fehlermeldung ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Ignoriert die fehlermeldung ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR .

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

Ignoriert Probleme mit der Zertifikatsperrung.

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

Ignoriert probleme mit unbekannten Zertifizierungsstellen.

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

Ignoriert Probleme mit schwachen Zertifikatsignaturen.

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

Ignoriert falsche Verwendungsprobleme.

SECURITY_FLAG_NORMALBITNESS

0x10000000

Identisch mit dem Wert SECURITY_FLAG_STRENGTH_WEAK. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

SECURITY_FLAG_PCT

0x00000008

Nicht implementiert.

SECURITY_FLAG_PCT4

0x00000010

Nicht implementiert.

SECURITY_FLAG_SECURE

0x00000001

Verwendet sichere Übertragungen. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

SECURITY_FLAG_SSL

0x00000002

Nicht implementiert.

SECURITY_FLAG_SSL3

0x00000004

Nicht implementiert.

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

Verwendet eine mittlere (56-Bit)-Verschlüsselung. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

Verwendet eine starke (128-Bit)-Verschlüsselung. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

Verwendet eine schwache (40-Bit)-Verschlüsselung. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

SECURITY_FLAG_UNKNOWNBIT

0x80000000

Die bei der Verschlüsselung verwendete Bitgröße ist unbekannt. Dies wird nur in einem Aufruf von InternetQueryOption zurückgegeben.

Beachten Sie, dass sich die auf diese Weise abgerufenen Daten auf eine transaktion beziehen, deren Sicherheitsstufe nicht mehr geändert werden kann.

INTERNET_OPTION_SECURITY_KEY_BITNESS

36

Ruft einen ganzzahligen Wert ohne Vorzeichen ab, der die Bitgröße des Verschlüsselungsschlüssels enthält. Je größer die Zahl, desto größer ist die verwendete Verschlüsselungsstärke. Dies wird von InternetQueryOption verwendet. Beachten Sie, dass sich die auf diese Weise abgerufenen Daten auf eine bereits durchgeführte Transaktion beziehen, deren Sicherheitsstufe nicht mehr geändert werden kann.

INTERNET_OPTION_SEND_THROUGHPUT

56

Nicht implementiert.

INTERNET_OPTION_SEND_TIMEOUT

5

Legt einen ganzzahligen Wert ohne Vorzeichen (in Millisekunden) fest, der den Timeoutwert zum Senden einer Anforderung enthält, oder ruft diesen ab. Wenn der Sendevorgang länger dauert als dieser Timeoutwert, wird der Sendevorgang abgebrochen. Diese Option kann für jedes HINTERNET-Handle verwendet werden, einschließlich eines NULL-Handles . Sie wird von InternetQueryOption und InternetSetOption verwendet.

Bei Verwendung in Bezug auf eine FTP-Transaktion bezieht sich diese Option auf den Steuerungskanal.

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105

Ruft den Zertifikatkettenkontext des Servers als duplizierte PCCERT_CHAIN_CONTEXT ab. Sie können diesen duplizierten Kontext an jede Crypto-API-Funktion übergeben, die eine PCCERT_CHAIN_CONTEXT. Sie müssen CertFreeCertificateChain für die zurückgegebene PCCERT_CHAIN_CONTEXT aufrufen, wenn Sie mit dem Zertifikatkettenkontext fertig sind.

Version: Erfordert Internet Explorer 8.0.

INTERNET_OPTION_SETTINGS_CHANGED

39

Benachrichtigt das System, dass die Registrierungseinstellungen geändert wurden, damit die Einstellungen beim nächsten Aufruf von InternetConnect überprüft werden. Dies wird von InternetSetOption verwendet.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

Legt ein HTTP-Anforderungsobjekt so fest, dass es sich nicht bei Ursprungsservern anmeldet, sondern eine automatische Anmeldung bei HTTP-Proxyservern ausführt. Diese Option unterscheidet sich vom Anforderungsflag INTERNET_FLAG_NO_AUTH, das die Authentifizierung sowohl bei Proxyservern als auch bei Ursprungsservern verhindert.

Durch das Festlegen dieses Modus wird die Verwendung von Anmeldeinformationsmaterial (entweder zuvor bereitgestellter Benutzername/Kennwort oder Client-SSL-Zertifikat) bei der Kommunikation mit einem Ursprungsserver unterdrückt. Wenn die Anforderung jedoch über einen authentifizierenden Proxy übertragen werden muss, führt WinINet weiterhin die automatische Authentifizierung beim HTTP-Proxy gemäß den Intranetzoneneinstellungen für den Benutzer durch. Die Standardeinstellung für Intranetzone besteht darin, die automatische Anmeldung mit den Standardanmeldeinformationen des Benutzers zuzulassen.

Um sicherzustellen, dass alle identifizierenden Informationen unterdrückt werden, sollte der Aufrufer INTERNET_OPTION_SUPPRESS_SERVER_AUTH mit dem INTERNET_FLAG_NO_COOKIES-Anforderungsflag kombinieren.

Diese Option kann nur für Anforderungsobjekte festgelegt werden, bevor sie gesendet wurden. Versuche, diese Option festzulegen, nachdem die Anforderung gesendet wurde, geben ERROR_INTERNET_INCORRECT_HANDLE_STATE zurück.

Für diese Option ist kein Puffer erforderlich. Dies wird von InternetSetOption nur für Handles verwendet, die von HttpOpenRequest zurückgegeben werden.

Version: Erfordert Internet Explorer 8.0 oder höher.

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81

Eine allgemeine Option, die verwendet wird, um Verhalten prozessweit zu unterdrücken. Der lpBuffer-Parameter der Funktion muss ein Zeiger auf ein DWORD sein, das das spezifische Verhalten enthält, das unterdrückt werden soll. Diese Option kann nicht mit InternetQueryOption abgefragt werden. Zulässige Werte sind:

INTERNET_SUPPRESS_RESET_ALL

0

Deaktiviert alle Unterdrückungen und aktiviert das standardbasierte und konfigurierte Verhalten erneut. Diese Option entspricht dem festlegen INTERNET_SUPPRESS_COOKIE_POLICY_RESET und INTERNET_SUPPRESS_COOKIE_PERSIST_RESET einzeln.

Version: Erfordert internet Explorer 6.0 oder höher.

INTERNET_SUPPRESS_COOKIE_POLICY

1

Ignoriert alle konfigurierten Cookierichtlinien und lässt das Setzen von Cookies zu.

Version: Erfordert internet Explorer 6.0 oder höher.

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

Deaktiviert die INTERNET_SUPPRESS_COOKIE_POLICY Unterdrückung, wodurch die Auswertung von Cookies gemäß der konfigurierten Cookie-Richtlinie ermöglicht wird.

Version: Erfordert internet Explorer 6.0 oder höher.

INTERNET_SUPPRESS_COOKIE_PERSIST

3

Unterdrückt die Persistenz von Cookies, auch wenn sie vom Server als persistent angegeben wurden.

Version: Erfordert Internet Explorer 8.0 oder höher.

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

Deaktiviert die INTERNET_SUPPRESS_COOKIE_PERSIST Unterdrückung und aktiviert die Persistenz von Cookies erneut. Alle zuvor unterdrückten Cookies werden nicht persistent.

Version: Erfordert Internet Explorer 8.0 oder höher.

INTERNET_OPTION_URL

34

Ruft einen Zeichenfolgenwert ab, der die vollständige URL einer heruntergeladenen Ressource enthält. Wenn die ursprüngliche URL zusätzliche Daten enthält, z. B. Suchzeichenfolgen oder Anker, oder wenn der Aufruf umgeleitet wurde, unterscheidet sich die zurückgegebene URL von der ursprünglichen. Diese Option gilt für HINTERNET-Handles , die von InternetOpenUrl, FtpOpenFile, GopherOpenFile oder HttpOpenRequest zurückgegeben werden. Es wird von InternetQueryOption verwendet.

INTERNET_OPTION_USER_AGENT

41

Legt die Benutzer-Agent-Zeichenfolge für Handles fest, die von InternetOpen bereitgestellt und in nachfolgenden HttpSendRequest-Funktionen verwendet werden, solange sie nicht von einem Header überschrieben wird, der von HttpAddRequestHeaders oder HttpSendRequest hinzugefügt wurde. Dies wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_USERNAME

28

Legt eine Zeichenfolge fest, die den Benutzernamen enthält, der einem von InternetConnect zurückgegebenen Handle zugeordnet ist, oder ruft sie ab. Dies wird von InternetQueryOption und InternetSetOption verwendet.

INTERNET_OPTION_VERSION

40

Ruft eine INTERNET_VERSION_INFO-Struktur ab, die die Versionsnummer von Wininet.dll enthält. Diese Option kann für ein NULLHINTERNET-Handle von InternetQueryOption verwendet werden.

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

Legt einen ganzzahligen Wert ohne Vorzeichen fest, der die Größe des Schreibpuffers in Bytes enthält, oder ruft diesen ab. Diese Option kann für HINTERNET-Handles verwendet werden, die von FtpOpenFile und InternetConnect zurückgegeben werden (nur FTP-Sitzung). Sie wird von InternetQueryOption und InternetSetOption verwendet.

Bemerkungen

Hinweis

WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst aus verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Wininet.h; Winineti.h