INTERNET_PER_CONN_OPTIONA Struktur (wininet.h)

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