API-Flags
Viele WinINet-Funktionen akzeptieren ein Array von Flags als Parameter. Im Folgenden finden Sie eine kurze Beschreibung der definierten Flags.
-
INTERNET _ COOKIE _ EVALUATE _ P3P
-
-
0x80
-
Gibt an, dass ein P3P-Header (Platform for Privacy Protection) einem Cookie zugeordnet werden soll.
-
-
INTERNET COOKIE THIRD PARTY (DRITTANBIETER _ FÜR _ _ INTERNETCOOKIES)
-
-
0x10
-
Gibt an, dass ein Drittanbietercookie festgelegt oder abgerufen wird.
-
-
_INTERNETFLAG _ ASYNC
-
-
0x10000000
-
Es werden nur asynchrone Anforderungen für Handles ausgeführt, die von dem von dieser Funktion zurückgegebenen Handle absteigend sind. Nur die InternetOpen-Funktion verwendet dieses Flag.
-
-
_INTERNETFLAGCACHE _ _ ASYNCHRON
-
-
0x00000080
-
Ermöglicht einen verzögerten Cache-Schreibzugriff.
-
-
_INTERNETFLAGCACHE _ BEI _ _ _ NET-FEHLER
-
-
0x00010000
-
Gibt die Ressource aus dem Cache zurück, wenn die Netzwerkanforderung für die Ressource aufgrund eines FEHLERs _ internet connection _ _ reset oder ERROR INTERNET CANNOT CONNECT error _ _ _ fehlschlägt. Dieses Flag wird von HttpOpenRequest verwendet.
-
-
_ _ INTERNETFLAG DONT _ CACHE
-
-
0x04000000
-
Fügt die zurückgegebene Entität nicht dem Cache hinzu. Dies ist identisch mit dem bevorzugten Wert _ _ INTERNETFLAG NO CACHE _ _ WRITE.
-
-
_ _ INTERNETFLAG EXISTING _ CONNECT
-
-
0x20000000
-
Versucht, ein vorhandenes InternetConnect-Objekt zu verwenden, wenn eines mit den gleichen 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 ein einzelnes Verbindungshand handle für jedes HINTERNET-Handle zwischen, das von InternetOpen generiert wird. Die Funktionen InternetOpenUrl und InternetConnect verwenden dieses Flag für HTTP- und FTP-Verbindungen.
-
-
SENDEN VON _ _ INTERNETFLAGFORMULAREN _
-
-
0x00000040
-
Gibt an, dass es sich um eine Formularübermittlung handelt.
-
-
_INTERNETFLAG _ AUS _ 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.
-
-
_ _ INTERNETFLAG 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 finden. Dieser Wert wurde in Microsoft Internet Explorer 5 eingeführt und ist den Schaltflächenvorgängen "Vorwärts" und "Zurück" der Internet Explorer.
-
-
LINK _ ZUM _ INTERNETFLAG
-
-
0x00000400
-
Erzwingt ein erneutes Laden, wenn keine Zeit abläuft und keine LastModified-Zeit vom Server zurückgegeben wird, wenn bestimmt wird, ob das Element erneut aus dem Netzwerk geladen werden soll. Dieses Flag kann von FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequestund InternetOpenUrl verwendet werden.
Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFile verwendet.
-
-
_ _ INTERNETFLAG IGNORE _ CERT _ CN _ INVALID
-
-
0x00001000
-
Deaktiviert die Überprüfung von SSL/PCT-basierten Zertifikaten, die vom Server zurückgegeben werden, anhand des in der Anforderung angegebenen Hostnamens. WinINet verwendet eine einfache Überprüfung auf Zertifikate, indem es vergleicht, ob Hostnamen und einfache Platzhalterregeln übereinstimmen. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.
-
-
_ _ INTERNETFLAG IGNORE _ CERT DATE _ _ INVALID
-
-
0x00002000
-
Deaktiviert die Überprüfung von SSL/PCT-basierten Zertifikaten auf ordnungsgemäße Gültigkeitsdauern. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.
-
-
INTERNETFLAG IGNORE REDIRECT TO HTTP (UMLEITUNG _ _ ZU HTTP _ _ _ IGNORIEREN)
-
-
0x00008000
-
Deaktiviert die Erkennung dieses speziellen Umleitungstyps. Wenn dieses Flag verwendet wird, lässt WinINet transparent Umleitungen von HTTPS zu HTTP-URLs zu. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.
-
-
INTERNETFLAG IGNORE REDIRECT TO HTTPS (UMLEITUNG _ _ ZU HTTPS _ _ _ IGNORIEREN)
-
-
0x00004000
-
Deaktiviert die Erkennung dieses speziellen Umleitungstyps. 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.
-
-
_INTERNETFLAG _ : VERBINDUNG _ HALTEN
-
-
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.
-
-
_INTERNETFLAG _ MAKE _ PERSISTENT
-
-
0x02000000
-
Wird nicht mehr unterstützt.
-
-
_ _ INTERNETFLAG MUSS ANFORDERUNG _ _ ZWISCHENSPEICHERN
-
-
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, HttpOpenRequestund InternetOpenUrl verwendet werden.
Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFile verwendet.
-
-
_INTERNETFLAG: _ DATEI _ "NEED"
-
-
0x00000010
-
Bewirkt, dass eine temporäre Datei erstellt wird, wenn die Datei nicht zwischengespeichert werden kann. Dieses Flag kann von FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequestund InternetOpenUrl verwendet werden.
Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFile verwendet.
-
-
_ _ INTERNETFLAG KEINE _ AUTHENTIFIZIERUNG
-
-
0x00040000
-
Versucht nicht automatisch, die Authentifizierung zu versuchen. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.
-
-
_INTERNETFLAG _ KEINE AUTOMATISCHE _ _ UMLEITUNG
-
-
0x00200000
-
Verarbeitet die Umleitung in HttpSendRequest nicht automatisch. Dieses Flag kann auch von InternetOpenUrl für HTTP-Anforderungen verwendet werden.
-
-
_INTERNETFLAG _ KEIN _ _ CACHE-SCHREIBZUGRIFF
-
-
0x04000000
-
Fügt die zurückgegebene Entität nicht dem Cache hinzu. Dieses Flag wird von , HttpOpenRequestund InternetOpenUrlverwendet.
Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFileverwendet.
-
-
_INTERNETFLAG _ KEINE _ COOKIES
-
-
0x00080000
-
Fügt Den Anforderungen nicht automatisch Cookieheader hinzu, und der Cookiedatenbank werden nicht automatisch zurückgegebene Cookies hinzugefügt. Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (für HTTP-Anforderungen) verwendet werden.
-
-
_INTERNETFLAG _ KEINE _ BENUTZEROBERFLÄCHE
-
-
0x00000200
-
Deaktiviert das Dialogfeld "Cookie". Dieses Flag kann von HttpOpenRequest und InternetOpenUrl (nur HTTP-Anforderungen) verwendet werden.
-
-
_INTERNETFLAG _ 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.
-
-
_INTERNETFLAG _ PASSIV
-
-
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.
-
-
_INTERNETFLAG _ PRAGMA _ NOCACHE
-
-
0x00000100
-
Erzwingt, dass die Anforderung vom Ursprungsserver aufgelöst wird, auch wenn eine zwischengespeicherte Kopie auf dem Proxy vorhanden ist. Die Funktion InternetOpenUrl (nur bei HTTP- und HTTPS-Anforderungen) und die HttpOpenRequest-Funktion verwenden dieses Flag.
-
-
_INTERNETFLAG- _ _ ROHDATEN
-
-
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 auch eine GOPHER _ FIND _ DATA-Struktur zurück, wenn Gopher-Verzeichnisinformationen abgerufen werden.
-
-
_INTERNETFLAG _ READ _ PREFETCH
-
-
0x00100000
-
Dieses Flag ist derzeit deaktiviert.
-
-
ERNEUTES _ LADEN DES INTERNETFLAGS _
-
-
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, HttpOpenRequestund InternetOpenUrl verwenden dieses Flag.
Windows XP und Windows Server 2003 R2 und früher: Wird auch von GopherFindFirstFile und GopherOpenFileverwendet.
-
-
_ _ EINGESCHRÄNKTE ZONE MIT INTERNETFLAG _
-
-
0x00020000
-
Gibt an, dass das festgelegte Cookie einer nicht vertrauenswürdigen Website zugeordnet ist.
-
-
_INTERNETFLAG _ NEU SYNCHRONISIEREN
-
-
0x00000800
-
Lädt HTTP-Ressourcen erneut, wenn die Ressource seit dem letzten Herunterladen geändert wurde. Alle FTP-Ressourcen werden neu geladen. Dieses Flag kann von FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequestund InternetOpenUrlverwendet werden.
Windows XP und Windows Server 2003 R2 und früher: Auch von GopherFindFirstFile und GopherOpenFileverwendet, und Gopher-Ressourcen werden neu geladen.
-
-
_INTERNETFLAG _ SICHER
-
-
0x00800000
-
Verwendung eine sichere Transaktionssemantik. Dies bedeutet die Verwendung Secure Sockets Layer/Private Communications Technology (SSL/PCT) und ist nur in HTTP-Anforderungen sinnvoll. Dieses Flag wird von HttpOpenRequest und InternetOpenUrlverwendet. 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.
-
-
_INTERNETFLAGÜBERTRAGUNG _ _ ASCII
-
-
0x00000001
-
Überträgt die Datei als ASCII (nur FTP). Dieses Flag kann von FtpOpenFile, FtpGetFileund FtpPutFileverwendet werden.
-
-
_ _ _ INTERNETFLAGÜBERTRAGUNGSBINÄRDATEI
-
-
0x00000002
-
Überträgt die Datei als Binärdatei (nur FTP). Dieses Flag kann von FtpOpenFile, FtpGetFileund FtpPutFileverwendet werden.
-
-
INTERNET _ OHNE _ RÜCKRUF
-
-
0x00000000
-
Gibt an, dass für diese API keine Rückrufe erfolgen sollen. Dies wird für den dxContext-Parameter der Funktionen verwendet, die asynchrone Vorgänge zulassen.
-
-
INTERNETOPTION UNTERDRÜCKEN DER _ _ _ _ SERVERAUTHENTIFIZIERUNG
-
-
104
-
Legt ein HTTP-Anforderungsobjekt so fest, dass es sich nicht bei Ursprungsservern anmeldet, sondern automatisch bei HTTP-Proxyservern anmeldet. Diese Option unterscheidet sich vom Anforderungsflag INTERNET _ FLAG _ NO _ AUTH, das die Authentifizierung bei Proxyservern und Ursprungsservern verhindert. Wenn Sie diesen Modus festlegen, wird die Verwendung von Anmeldeinformationen (entweder zuvor bereitgestellter Benutzername/Kennwort oder CLIENT-SSL-Zertifikat) bei der Kommunikation mit einem Ursprungsserver unterdrückt. Wenn die Anforderung jedoch über einen Authentifizierungsproxy übertragen werden muss, führt WinINet weiterhin die automatische Authentifizierung beim HTTP-Proxy gemäß den Intranetzoneneinstellungen für den Benutzer durch. Die Standardeinstellung Intranetzone ist das Zulassen der automatischen Anmeldung mit den Standardanmeldeinformationen des Benutzers. Um die Unterdrückung aller identifizierenden Informationen sicherzustellen, sollte der Aufrufer INTERNET _ OPTION _ SUPPRESS SERVER _ _ AUTH mit dem _ _ Anforderungsflag INTERNET FLAG NO _ COOKIES kombinieren. Diese Option kann nur für Anforderungsobjekte festgelegt werden, bevor sie gesendet wurden. Wenn versucht wird, diese Option festzulegen, nachdem die Anforderung gesendet wurde, wird ERROR _ INTERNET INCORRECT HANDLE STATE _ _ _ zurückgegeben. 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-FLAGSYNCHRONISIERUNG _
-
-
0x00000004
-
Erzwingt synchrone Vorgänge.
-
-
VERWENDUNGSKONTEXT DES _ WININET-API-FLAGS _ _ _
-
-
0x00000008
-
Erzwingt, dass die API den Kontextwert verwendet, auch wenn er auf 0 (null) festgelegt ist.
-
Hinweise
Hinweis
WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte sie nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder -dienste Microsoft Windows HTTP-Dienste (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 |
|