API-Flags

Viele der WinINet-Funktionen akzeptieren ein Array von Flags als Parameter. Im Folgenden werden die definierten Flags kurz beschrieben.

INTERNET_COOKIE_EVALUATE_P3P

0x80

Gibt an, dass ein P3P-Header (Platform for Privacy Protection) einem Cookie zugeordnet werden soll.

INTERNET_COOKIE_THIRD_PARTY

0x10

Gibt an, dass ein Drittanbietercookies festgelegt oder abgerufen wird.

INTERNET_FLAG_ASYNC

0x10000000

Führt nur asynchrone Anforderungen für Handles aus, die vom von dieser Funktion zurückgegebenen Handle abstammen. Nur die InternetOpen-Funktion verwendet dieses Flag.

INTERNET_FLAG_CACHE_ASYNC

0x00000080

Ermöglicht einen verzögerten Cacheschreibvorgang.

INTERNET_FLAG_CACHE_IF_NET_FAIL

0x00010000

Gibt die Ressource aus dem Cache zurück, wenn die Netzwerkanforderung für die Ressource aufgrund eines ERROR_INTERNET_CONNECTION_RESET- oder ERROR_INTERNET_CANNOT_CONNECT-Fehlers fehlschlägt. Dieses Flag wird von HttpOpenRequest verwendet.

INTERNET_FLAG_DONT_CACHE

0x04000000

Fügt die zurückgegebene Entität nicht dem Cache hinzu. Dies ist identisch mit dem bevorzugten Wert , INTERNET_FLAG_NO_CACHE_WRITE.

INTERNET_FLAG_EXISTING_CONNECT

0x20000000

Versucht, ein vorhandenes InternetConnect-Objekt zu verwenden, wenn eines mit denselben Attributen vorhanden ist, die für die Anforderung erforderlich sind. Dies ist nur bei FTP-Vorgängen nützlich, da FTP das einzige Protokoll ist, das in der Regel mehrere Vorgänge während derselben Sitzung ausführt. WinINet speichert für jedes von InternetOpen generierte HINTERNET-Handle ein einzelnes Verbindungshandle zwischen. Die Funktionen InternetOpenUrl und InternetConnect verwenden dieses Flag für HTTP- und FTP-Verbindungen.

INTERNET_FLAG_FORMS_SUBMIT

0x00000040

Gibt an, dass es sich um eine Formularübermittlung handelt.

INTERNET_FLAG_FROM_CACHE

0x01000000

Stellt keine Netzwerkanforderungen. Alle Entitäten werden aus dem Cache zurückgegeben. Wenn sich das angeforderte Element nicht im Cache befindet, wird ein geeigneter Fehler zurückgegeben, z. B. ERROR_FILE_NOT_FOUND. Nur die InternetOpen-Funktion verwendet dieses Flag.

INTERNET_FLAG_FWD_BACK

0x00000020

Gibt an, dass die Funktion die Kopie der Ressource verwenden soll, die sich derzeit im Internetcache befindet. Das Ablaufdatum und andere Informationen zur Ressource werden nicht überprüft. Wenn das angeforderte Element nicht im Internetcache gefunden wird, versucht das System, die Ressource im Netzwerk zu suchen. Dieser Wert wurde in Microsoft Internet Explorer 5 eingeführt und ist den Schaltflächenvorgängen Vorwärts und Zurück von Internet Explorer zugeordnet.

INTERNET_FLAG_HYPERLINK

0x00000400

Erzwingt ein Erneutes Laden, wenn keine Ablaufzeit und keine LastModified-Zeit vom Server zurückgegeben wird, wenn ermittelt wird, ob das Element aus dem Netzwerk neu geladen werden soll. Dieses Flag kann von FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest und InternetOpenUrl verwendet werden.

Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFile verwendet.

INTERNET_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Deaktiviert die Überprüfung von SSL-/PCT-basierten Zertifikaten, die vom Server mit dem in der Anforderung angegebenen Hostnamen zurückgegeben werden. WinINet verwendet eine einfache Überprüfung von Zertifikaten, indem für übereinstimmende Hostnamen und einfache Wildcardregeln verglichen wird. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.

INTERNET_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Deaktiviert die Überprüfung von SSL-/PCT-basierten Zertifikaten auf ordnungsgemäße Gültigkeitsdaten. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Deaktiviert die Erkennung dieser speziellen Umleitungsart. Wenn dieses Flag verwendet wird, lässt WinINet Umleitungen von HTTPS zu HTTP-URLs transparent zu. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Deaktiviert die Erkennung dieser speziellen Umleitungsart. Wenn dieses Flag verwendet wird, lässt WinINet Umleitungen von HTTP zu HTTPS-URLs transparent zu. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.

INTERNET_FLAG_KEEP_CONNECTION

0x00400000

Verwendet keep-alive-Semantik, sofern verfügbar, für die Verbindung. Dieses Flag wird von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet. Dieses Flag ist für Microsoft Network (MSN), NTLM und andere Authentifizierungstypen erforderlich.

INTERNET_FLAG_MAKE_PERSISTENT

0x02000000

Wird nicht mehr unterstützt.

INTERNET_FLAG_MUST_CACHE_REQUEST

0x00000010

Identisch mit dem bevorzugten Wert , INTERNET_FLAG_NEED_FILE. Bewirkt, dass eine temporäre Datei erstellt wird, wenn die Datei nicht zwischengespeichert werden kann. Dieses Flag kann von FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest und InternetOpenUrl verwendet werden.

Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFile verwendet.

INTERNET_FLAG_NEED_FILE

0x00000010

Bewirkt, dass eine temporäre Datei erstellt wird, wenn die Datei nicht zwischengespeichert werden kann. Dieses Flag kann von FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest und InternetOpenUrl verwendet werden.

Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFile verwendet.

INTERNET_FLAG_NO_AUTH

0x00040000

Versucht nicht automatisch die Authentifizierung. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.

INTERNET_FLAG_NO_AUTO_REDIRECT

0x00200000

Behandelt die Umleitung in HttpSendRequest nicht automatisch. Dieses Flag kann auch von InternetOpenUrl für HTTP-Anforderungen verwendet werden.

INTERNET_FLAG_NO_CACHE_WRITE

0x04000000

Fügt die zurückgegebene Entität nicht dem Cache hinzu. Dieses Flag wird von , HttpOpenRequest und InternetOpenUrl verwendet.

Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFile verwendet.

INTERNET_FLAG_NO_COOKIES

0x00080000

Fügt Anforderungen nicht automatisch Cookie-Header hinzu und fügt der Cookie-Datenbank nicht automatisch zurückgegebene Cookies hinzu. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.

INTERNET_FLAG_NO_UI

0x00000200

Deaktiviert das Dialogfeld "Cookie". Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (nur HTTP-Anforderungen) verwendet werden.

INTERNET_FLAG_OFFLINE

0x01000000

Identisch mit INTERNET_FLAG_FROM_CACHE. Stellt keine Netzwerkanforderungen. Alle Entitäten werden aus dem Cache zurückgegeben. Wenn sich das angeforderte Element nicht im Cache befindet, wird ein geeigneter Fehler zurückgegeben, z. B. ERROR_FILE_NOT_FOUND. Nur die InternetOpen-Funktion verwendet dieses Flag.

INTERNET_FLAG_PASSIVE

0x08000000

Verwendet passive FTP-Semantik. Nur InternetConnect und InternetOpenUrl verwenden dieses Flag. InternetConnect verwendet dieses Flag für FTP-Anforderungen, und InternetOpenUrl verwendet dieses Flag für FTP-Dateien und Verzeichnisse.

INTERNET_FLAG_PRAGMA_NOCACHE

0x00000100

Erzwingt, dass die Anforderung vom Ursprungsserver aufgelöst wird, auch wenn eine zwischengespeicherte Kopie auf dem Proxy vorhanden ist. Die InternetOpenUrl-Funktion (nur für HTTP- und HTTPS-Anforderungen) und die HttpOpenRequest-Funktion verwenden dieses Flag.

INTERNET_FLAG_RAW_DATA

0x40000000

Gibt die Daten beim Abrufen von FTP-Verzeichnisinformationen als WIN32_FIND_DATA-Struktur zurück. Wenn dieses Flag nicht angegeben ist oder der Aufruf über einen CERN-Proxy erfolgt, gibt InternetOpenUrl die HTML-Version des Verzeichnisses zurück. Nur die InternetOpenUrl-Funktion verwendet dieses Flag.

Windows XP und Windows Server 2003 R2 und früher: Gibt beim Abrufen von Gopher-Verzeichnisinformationen auch eine GOPHER_FIND_DATA-Struktur zurück.

INTERNET_FLAG_READ_PREFETCH

0x00100000

Dieses Flag ist derzeit deaktiviert.

INTERNET_FLAG_RELOAD

0x80000000

Erzwingt einen Download der angeforderten Datei, des angeforderten Objekts oder der angeforderten Verzeichnisliste vom ursprünglichen Server, nicht aus dem Cache. Die Funktionen FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest und InternetOpenUrl verwenden dieses Flag.

Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFile verwendet.

INTERNET_FLAG_RESTRICTED_ZONE

0x00020000

Gibt an, dass das gesetzte Cookie einer nicht vertrauenswürdigen Website zugeordnet ist.

INTERNET_FLAG_RESYNCHRONIZE

0x00000800

Lädt HTTP-Ressourcen neu, wenn die Ressource seit dem letzten Download geändert wurde. Alle FTP-Ressourcen werden erneut geladen. Dieses Flag kann von FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest und InternetOpenUrl verwendet werden.

Windows XP und Windows Server 2003 R2 und früher: Auch von GopherFindFirstFile und GopherOpenFile verwendet, und Gopher-Ressourcen werden erneut geladen.

INTERNET_FLAG_SECURE

0x00800000

Verwendung eine sichere Transaktionssemantik. Dies bedeutet die Verwendung von Secure Sockets Layer/Private Communications Technology (SSL/PCT) und ist nur in HTTP-Anforderungen sinnvoll. Dieses Flag wird von HttpOpenRequest und InternetOpenUrl verwendet. Dies ist jedoch redundant, wenn https:// in der URL angezeigt wird. Die InternetConnect-Funktion verwendet dieses Flag für HTTP-Verbindungen. Alle Anforderungshandles, die unter dieser Verbindung erstellt wurden, erben dieses Flag.

INTERNET_FLAG_TRANSFER_ASCII

0x00000001

Überträgt die Datei als ASCII (nur FTP). Dieses Flag kann von FtpOpenFile, FtpGetFile und FtpPutFile verwendet werden.

INTERNET_FLAG_TRANSFER_BINARY

0x00000002

Überträgt die Datei als Binärdatei (nur FTP). Dieses Flag kann von FtpOpenFile, FtpGetFile und FtpPutFile verwendet werden.

INTERNET_NO_CALLBACK

0x00000000

Gibt an, dass für diese API keine Rückrufe durchgeführt werden sollen. Dies wird für den dxContext-Parameter der Funktionen verwendet, die asynchrone Vorgänge zulassen.

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.

WININET_API_FLAG_ASYNC

0x00000001

Erzwingt asynchrone Vorgänge.

WININET_API_FLAG_SYNC

0x00000004

Erzwingt synchrone Vorgänge.

WININET_API_FLAG_USE_CONTEXT

0x00000008

Erzwingt, dass die API den Kontextwert verwendet, auch wenn er auf 0 (null) festgelegt ist.

Bemerkungen

Hinweis

WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst 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