InternetOpenA-Funktion (wininet.h)
Initialisiert die Verwendung der WinINet-Funktionen einer Anwendung.
Syntax
HINTERNET InternetOpenA(
[in] LPCSTR lpszAgent,
[in] DWORD dwAccessType,
[in] LPCSTR lpszProxy,
[in] LPCSTR lpszProxyBypass,
[in] DWORD dwFlags
);
Parameter
[in] lpszAgent
Zeiger auf eine NULL--terminated-Zeichenfolge, die den Namen der Anwendung oder Entität angibt, die die WinINet-Funktionen aufruft. Dieser Name wird als Benutzer-Agent im HTTP-Protokoll verwendet.
[in] dwAccessType
Typ des erforderlichen Zugriffs. Dieser Parameter kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
Löst alle Hostnamen lokal auf. |
|
Ruft den Proxy oder die direkte Konfiguration aus der Registrierung ab. |
|
Ruft den Proxy oder die direkte Konfiguration aus der Registrierung ab und verhindert die Verwendung einer Startdatei von Microsoft JScript oder Internet Setup (INS). |
|
Übergibt Anforderungen an den Proxy, es sei denn, eine Proxyumgehungsliste wird angegeben, und der name, der aufgelöst werden soll, umgeht den Proxy. In diesem Fall verwendet die Funktion INTERNET_OPEN_TYPE_DIRECT. |
[in] lpszProxy
Zeigen Sie auf eine null--terminated-Zeichenfolge, die den Namen der Proxyserver angibt, die verwendet werden sollen, wenn der Proxyzugriff angegeben wird, indem Sie dwAccessType- auf INTERNET_OPEN_TYPE_PROXYfestlegen. Verwenden Sie keine leere Zeichenfolge, da InternetOpen sie als Proxynamen verwendet. Die WinINet-Funktionen erkennen nur CERN-Typproxys (nur HTTP) und das TIS FTP-Gateway (nur FTP). Wenn Microsoft Internet Explorer installiert ist, unterstützen diese Funktionen auch SOCKEN-Proxys. FTP-Anforderungen können über einen CERN-Typproxy erfolgen, indem sie entweder in eine HTTP-Anforderung oder mithilfe InternetOpenUrl-geändert werden. Wenn dwAccessType- nicht auf INTERNET_OPEN_TYPE_PROXYfestgelegt ist, wird dieser Parameter ignoriert und sollte NULL-sein. Weitere Informationen zum Auflisten von Proxyservern finden Sie im Abschnitt Eintragsproxyserver abschnitt Aktivieren von Internetfunktionalität.
[in] lpszProxyBypass
Zeiger auf eine NULL--terminated-Zeichenfolge, die eine optionale Liste von Hostnamen oder IP-Adressen angibt, die nicht über den Proxy weitergeleitet werden sollten, wenn dwAccessType- auf INTERNET_OPEN_TYPE_PROXYfestgelegt ist. Die Liste kann Wildcards enthalten. Verwenden Sie keine leere Zeichenfolge, da InternetOpen sie als Proxyumgehungsliste verwendet. Wenn dieser Parameter das Makro "<lokalen>" angibt, wird der Proxy für jeden Hostnamen umgangen, der keinen Punkt enthält.
Standardmäßig umgehen WinINet den Proxy für Anforderungen, die die Hostnamen "localhost", "loopback", "127.0.0.1" oder "[::1]" verwenden. Dieses Verhalten ist vorhanden, da diese Adressen von einem Remoteproxyserver normalerweise nicht ordnungsgemäß aufgelöst werden.Internet Explorer 9: Sie können den lokalen Computer mithilfe des Makros "<-loopback>" aus der Proxyumgehungsliste entfernen.
Wenn dwAccessType- nicht auf INTERNET_OPEN_TYPE_PROXYfestgelegt ist, wird dieser Parameter ignoriert und sollte NULL-sein.
[in] dwFlags
Optionen. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.
| Wert | Bedeutung |
|---|---|
|
Führt nur asynchrone Anforderungen für Handles ab, die vom von dieser Funktion zurückgegebenen Handle absteigen. |
|
Stellt keine Netzwerkanforderungen vor. Alle Entitäten werden aus dem Cache zurückgegeben. Wenn sich das angeforderte Element nicht im Cache befindet, wird ein geeigneter Fehler wie ERROR_FILE_NOT_FOUND zurückgegeben. |
|
Identisch mit INTERNET_FLAG_FROM_CACHE. Stellt keine Netzwerkanforderungen vor. Alle Entitäten werden aus dem Cache zurückgegeben. Wenn sich das angeforderte Element nicht im Cache befindet, wird ein geeigneter Fehler wie ERROR_FILE_NOT_FOUND zurückgegeben. |
Rückgabewert
Gibt ein gültiges Handle zurück, das die Anwendung an nachfolgende WinINet-Funktionen übergibt. Wenn InternetOpen fehlschlägt, wird NULL-zurückgegeben. Rufen Sie GetLastErrorauf, um eine bestimmte Fehlermeldung abzurufen.
Bemerkungen
InternetOpen ist die erste WinINet-Funktion, die von einer Anwendung aufgerufen wird. Sie teilt der Internet-DLL mit, interne Datenstrukturen zu initialisieren und auf zukünftige Aufrufe der Anwendung vorzubereiten. Wenn die Anwendung die Verwendung der Internetfunktionen abgeschlossen hat, sollte sie InternetCloseHandle- aufrufen, um das Handle und alle zugehörigen Ressourcen freizugeben.
Die Anwendung kann eine beliebige Anzahl von Anrufen an InternetOpentätigen, obwohl ein einzelner Anruf normalerweise ausreicht. Die Anwendung muss möglicherweise separate Verhaltensweisen für jede InternetOpen Instanz definieren, z. B. für die einzelnen proxyserver konfiguriert.
Nachdem die aufrufende Anwendung die verwendung des HINTERNET- Handle beendet hat, das von InternetOpenzurückgegeben wird, muss sie mit der InternetCloseHandle--Funktion geschlossen werden.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.
Anmerkung
Der wininet.h-Header definiert InternetOpen 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] |
| Zielplattform- | Fenster |
| Header- | wininet.h |
| Library | Wininet.lib |
| DLL- | Wininet.dll |