INTERNET_PER_CONN_OPTIONW Struktur (wininet.h)

Enthält den Wert einer Option.

Syntax

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPWSTR   pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONW, *LPINTERNET_PER_CONN_OPTIONW;

Angehörige

dwOption

Option, die abgefragt oder festgelegt werden soll. Dieses Element kann einer der folgenden Werte sein:

Wert	Bedeutung
INTERNET_PER_CONN_AUTOCONFIG_URL	Legt eine Zeichenfolge fest, die die URL zum Skript für die automatische Konfiguration enthält, oder ruft diese ab.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	Legt die Einstellungen für die automatische Ermittlung fest oder ruft sie ab. Das element Value enthält einen oder mehrere der folgenden Werte: AUTO_PROXY_FLAG_ALWAYS_DETECT Einstellungen immer automatisch erkennen. AUTO_PROXY_FLAG_CACHE_INIT_RUN Gibt an, dass die zwischengespeicherten Ergebnisse des Skripts für die automatische Proxykonfiguration verwendet werden sollten, 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 Zurzeit 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 element Value enthält einen oder mehrere 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 automatisch Einstellungen.
INTERNET_PER_CONN_PROXY_BYPASS	Legt eine Zeichenfolge fest oder ruft sie ab, die die URLs enthält, die den Proxyserver nicht verwenden.
INTERNET_PER_CONN_PROXY_SERVER	Legt eine Zeichenfolge fest, die die Proxyserver enthält, oder ruft diese 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 Autoconfig-URL für Proxyinformationen festlegt.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	von Minuten bis zur automatischen Aktualisierung der AutoConfig-URL durch AutoErmittlung.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	Option "Schreibgeschützt". Gibt die Uhrzeit zurück, zu der die letzte bekannte autoconfig-URL mithilfe der AutoErmittlung gefunden wurde.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	Option "Schreibgeschützt". 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_UIabfragen. Wenn diese Abfrage fehlschlägt, wird vom System eine frühere Version von Internet Explorer ausgeführt, und der Client sollte erneut mit INTERNET_PER_CONN_FLAGSabfragen.

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

Wert

Bedeutung

INTERNET_PER_CONN_FLAGS_UI

Legt den Verbindungstyp fest oder ruft den Verbindungstyp ab. Das element Value enthält einen oder mehrere 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 automatisch Einstellungen.

Value

Union, die den Wert für die Option enthält. Je nach Wert von dwOptionkann es sich um einen der folgenden Typen handeln:

dwValue

Unsigned long integer value.

pszValue

Zeiger auf einen Zeichenfolgenwert.

ftValue

Eine FILETIME- Struktur.

Value.dwValue

Unsigned long integer value.

Value.pszValue

Zeiger auf einen Zeichenfolgenwert.

Value.ftValue

Eine FILETIME- Struktur.

Bemerkungen

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, InternetQueryOption den Speicher für das pszValue Element der Struktur zu. Die aufrufende Anwendung muss diesen Speicher mit der GlobalFree-Funktion freigeben, wenn sie die Zeichenfolge verwendet hat.

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

 

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	wininet.h

Siehe auch

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption-

InternetSetOption-