INTERNET_PER_CONN_OPTIONA Struktur (wininet.h)

  • Artikel

Enthält den Wert einer Option.

Syntax

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPSTR    pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONA, *LPINTERNET_PER_CONN_OPTIONA;

Member

dwOption

Option, die abgefragt oder festgelegt werden soll. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
INTERNET_PER_CONN_AUTOCONFIG_URL
 Legt eine Zeichenfolge fest, die die URL für das automatische Konfigurationsskript enthält, oder ruft sie ab.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS
 Legt die Einstellungen für die automatische Ermittlung fest oder ruft sie ab. Das Value-Element enthält mindestens einen der folgenden Werte:
AUTO_PROXY_FLAG_ALWAYS_DETECT
Einstellungen werden immer automatisch erkannt.
AUTO_PROXY_FLAG_CACHE_INIT_RUN
Gibt an, dass die zwischengespeicherten Ergebnisse des Skripts für die automatische Proxykonfiguration verwendet werden sollen, anstatt das Skript tatsächlich auszuführen, es sei denn, die zwischengespeicherte Datei ist abgelaufen.
AUTO_PROXY_FLAG_DETECTION_RUN
Die automatische Erkennung wurde mindestens einmal für diese Verbindung ausgeführt.
AUTO_PROXY_FLAG_DETECTION_SUSPECT
Wird derzeit nicht unterstützt.
AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT
Lassen Sie das Zwischenspeichern des Ergebnisses des Skripts für die automatische Proxykonfiguration nicht zu.
AUTO_PROXY_FLAG_MIGRATED
Die Einstellung wurde von einer Microsoft Internet Explorer 4.0-Installation migriert, und die automatische Erkennung sollte einmal versucht werden.
AUTO_PROXY_FLAG_USER_SET
Der Benutzer hat die automatische Erkennung explizit festgelegt.
INTERNET_PER_CONN_FLAGS
 Legt den Verbindungstyp fest oder ruft den Verbindungstyp ab. Das Value-Element enthält mindestens einen der folgenden Werte:
PROXY_TYPE_DIRECT
Die Verbindung verwendet keinen Proxyserver.
PROXY_TYPE_PROXY
Die Verbindung verwendet einen explizit festgelegten Proxyserver.
PROXY_TYPE_AUTO_PROXY_URL
Die Verbindung lädt ein automatisches Konfigurationsskript unter einer angegebenen URL herunter und verarbeitet es.
PROXY_TYPE_AUTO_DETECT
Die Verbindung erkennt Einstellungen automatisch.
INTERNET_PER_CONN_PROXY_BYPASS
 Legt eine Zeichenfolge fest, die die URLs enthält, die den Proxyserver nicht verwenden, oder ruft sie ab.
INTERNET_PER_CONN_PROXY_SERVER
 Legt eine Zeichenfolge fest, die die Proxyserver enthält, oder ruft sie ab.
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL
 VERKETTETE AUTOCONFIG-URL. Wird verwendet, wenn die primäre autoconfig-URL auf eine INS-Datei verweist, die eine zweite Autokonfigurations-URL für Proxyinformationen festlegt.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS
 von Minuten bis zur automatischen Aktualisierung der Autokonfigurations-URL durch autoErmittlung.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME
 Schreibgeschützte Option. Gibt den Zeitpunkt zurück, zu dem die letzte bekannte gute Autoconfig-URL mithilfe der AutoErmittlung gefunden wurde.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL
 Schreibgeschützte Option. Gibt die letzte bekannte gute URL zurück, die mithilfe der AutoErmittlung gefunden wurde.
 

Windows 7 und höher:

Clients, die Internet Explorer 8 unterstützen, sollten den Verbindungstyp mithilfe von INTERNET_PER_CONN_FLAGS_UI abfragen. Wenn diese Abfrage fehlschlägt, führt das System eine frühere Version von Internet Explorer aus, und der Client sollte erneut mit INTERNET_PER_CONN_FLAGS abfragen.

Stellen Sie den Verbindungstyp mithilfe von INTERNET_PER_CONN_FLAGS unabhängig von der Version von Internet Explorer wieder her.

Wert Bedeutung
INTERNET_PER_CONN_FLAGS_UI
 Legt den Verbindungstyp fest oder ruft den Verbindungstyp ab. Das Value-Element enthält mindestens einen der folgenden Werte:
PROXY_TYPE_DIRECT
Die Verbindung verwendet keinen Proxyserver.
PROXY_TYPE_PROXY
Die Verbindung verwendet einen explizit festgelegten Proxyserver.
PROXY_TYPE_AUTO_PROXY_URL
Die Verbindung lädt ein automatisches Konfigurationsskript unter einer angegebenen URL herunter und verarbeitet es.
PROXY_TYPE_AUTO_DETECT
Die Verbindung erkennt Einstellungen automatisch.

Value

Union, die den Wert für die Option enthält. Abhängig vom Wert von dwOption kann es sich um einen der folgenden Typen handeln:

dwValue

Ganzzahliger Wert ohne Vorzeichen.

pszValue

Zeiger auf einen Zeichenfolgenwert.

ftValue

Eine FILETIME-Struktur .

Value.dwValue

Value.pszValue

Value.ftValue

Hinweise

In Internet Explorer 5 funktionieren nur die ANSI-Versionen von InternetQueryOption und InternetSetOption mit der INTERNET_PER_CONN_OPTION-Struktur. Die Unicode-Versionen unterstützen die INTERNET_PER_CONN_OPTION-Struktur in späteren Versionen von Internet Explorer.

Bei Abfragen, die Zeichenfolgen zurückgeben, weist InternetQueryOption den Arbeitsspeicher für das pszValue-Element der Struktur zu. Die aufrufende Anwendung muss diesen Arbeitsspeicher mithilfe der GlobalFree-Funktion freigeben, wenn die Verwendung der Zeichenfolge abgeschlossen ist.

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).
 

Hinweis

Der wininet.h-Header definiert INTERNET_PER_CONN_OPTION als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile wininet.h

Weitere Informationen

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption