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
Wininet.h