InternetOpenUrlW-Funktion (wininet.h)
Öffnet eine Ressource, die durch eine vollständige FTP- oder HTTP-URL angegeben wird.
Syntax
HINTERNET InternetOpenUrlW(
[in] HINTERNET hInternet,
[in] LPCWSTR lpszUrl,
[in] LPCWSTR lpszHeaders,
[in] DWORD dwHeadersLength,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
Parameter
[in] hInternet
Das Handle für die aktuelle Internetsitzung. Das Handle muss von einem vorherigen Aufruf von InternetOpen zurückgegeben worden sein.
[in] lpszUrl
Ein Zeiger auf eine NULL-beendete Zeichenfolgenvariable, die die URL angibt, die mit dem Lesen beginnen soll. Nur URLs ab ftp:, http:, oder https: werden unterstützt.
[in] lpszHeaders
Ein Zeiger auf eine null-beendete Zeichenfolge, die die Header angibt, die an den HTTP-Server gesendet werden sollen. Weitere Informationen finden Sie in der Beschreibung des lpszHeaders-Parameters in der HttpSendRequest-Funktion .
[in] dwHeadersLength
Die Größe der zusätzlichen Header in TCHARs. Wenn dieser Parameter -1L ist und lpszHeaders nicht NULL ist, wird davon ausgegangen, dass lpszHeaders null beendet (ASCIIZ) ist, und die Länge wird berechnet.
[in] dwFlags
Dieser Parameter kann einen der folgenden Werte annehmen.
Wert | Bedeutung |
---|---|
|
Versucht, ein vorhandenes InternetConnect-Objekt zu verwenden, wenn es mit denselben 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. Die WinINet-API speichert ein einzelnes Verbindungshandle für jedes von InternetOpen generierte HINTERNET-Handle zwischen. InternetOpenUrl verwendet dieses Flag für HTTP- und FTP-Verbindungen. |
|
Erzwingt ein Erneutes Laden, wenn keine Ablaufzeit und keine LastModified-Zeit vom Server zurückgegeben wurde, wenn ermittelt wird, ob das Element aus dem Netzwerk neu geladen werden soll. |
|
Deaktiviert die Überprüfung von SSL-/PCT-basierten Zertifikaten, die vom Server mit dem in der Anforderung angegebenen Hostnamen zurückgegeben werden. WinINet-Funktionen verwenden eine einfache Überprüfung mit Zertifikaten, indem sie für übereinstimmende Hostnamen und einfache Wildcardregeln vergleichen. |
|
Deaktiviert die Überprüfung von SSL-/PCT-basierten Zertifikaten auf ordnungsgemäße Gültigkeitsdaten. |
|
Deaktiviert die Erkennung dieser speziellen Umleitungsart. Wenn dieses Flag verwendet wird, lässt WinINet Transparent Umleitungen von HTTPS zu HTTP-URLs zu. |
|
Deaktiviert die Erkennung dieses speziellen Typs der Umleitung. Wenn dieses Flag verwendet wird, lässt WinINet Transparent Umleitungen von HTTP zu HTTPS-URLs zu. |
|
Verwendet Keep-Alive-Semantik, sofern verfügbar, für die Verbindung. Dieses Flag ist für Microsoft Network (MSN), NTLM und andere Authentifizierungstypen erforderlich. |
|
Bewirkt, dass eine temporäre Datei erstellt wird, wenn die Datei nicht zwischengespeichert werden kann. |
|
Versucht nicht automatisch die Authentifizierung. |
|
Die Umleitung in HttpSendRequest wird nicht automatisch verarbeitet. |
|
Fügt die zurückgegebene Entität nicht dem Cache hinzu. |
|
Fügt Nicht automatisch Cookie-Header zu Anforderungen hinzu und fügt der Cookie-Datenbank nicht automatisch zurückgegebene Cookies hinzu. |
|
Deaktiviert das Cookie-Dialogfeld. |
|
Verwendet passive FTP-Semantik. InternetOpenUrl verwendet dieses Flag für FTP-Dateien und Verzeichnisse. |
|
Erzwingt, dass die Anforderung vom Ursprungsserver aufgelöst wird, auch wenn eine zwischengespeicherte Kopie auf dem Proxy vorhanden ist. |
|
Gibt die Daten als WIN32_FIND_DATA-Struktur zurück, wenn FTP-Verzeichnisinformationen abgerufen werden. Wenn dieses Flag nicht angegeben ist oder wenn der Aufruf über einen CERN-Proxy erfolgt ist, gibt InternetOpenUrl die HTML-Version des Verzeichnisses zurück.
Windows XP und Windows Server 2003 R2 und früher: Gibt auch Daten als GOPHER_FIND_DATA-Struktur zurück, wenn Gopher-Verzeichnisinformationen abgerufen werden. |
|
Erzwingt einen Download der angeforderten Datei, des angeforderten Objekts oder der angeforderten Verzeichnisliste vom ursprünglichen Server, nicht aus dem Cache. |
|
Lädt HTTP-Ressourcen neu, wenn die Ressource seit dem letzten Download geändert wurde. Alle FTP-Ressourcen werden neu geladen.
Windows XP und Windows Server 2003 R2 und früher: Gopher-Ressourcen werden ebenfalls neu geladen. |
|
Verwendung eine sichere Transaktionssemantik. Dies übersetzt die Verwendung von Secure Sockets Layer/Private Communications Technology (SSL/PCT) und ist nur in HTTP-Anforderungen sinnvoll. |
[in] dwContext
Ein Zeiger auf eine Variable, die den anwendungsdefinierten Wert angibt, der zusammen mit dem zurückgegebenen Handle an alle Rückruffunktionen übergeben wird.
Rückgabewert
Gibt ein gültiges Handle für die URL zurück, wenn die Verbindung erfolgreich hergestellt wurde, oder NULL , wenn die Verbindung fehlschlägt. Um eine bestimmte Fehlermeldung abzurufen, rufen Sie GetLastError auf. Rufen Sie InternetGetLastResponseInfo auf, um zu ermitteln, warum der Zugriff auf den Dienst verweigert wurde.
Hinweise
Rufen Sie zuerst InternetCanonicalizeUrl auf, wenn die verwendete URL eine relative URL und eine durch Leerzeichen getrennte Basis-URL enthält.
Dies ist eine allgemeine Funktion, die eine Anwendung verwenden kann, um Daten über eines der von WinINet unterstützten Protokolle abzurufen. Diese Funktion ist besonders nützlich, wenn die Anwendung nicht auf die Besonderheiten eines Protokolls zugreifen muss, sondern nur die Daten benötigt, die einer URL entsprechen. Die InternetOpenUrl-Funktion analysiert die URL-Zeichenfolge, stellt eine Verbindung mit dem Server her und bereitet den Download der durch die URL identifizierten Daten vor. Die Anwendung kann dann InternetReadFile (für Dateien) oder InternetFindNextFile (für Verzeichnisse) verwenden, um die URL-Daten abzurufen. Es ist nicht erforderlich, InternetConnect vor InternetOpenUrl aufzurufen.
Windows XP und Windows Server 2003 R2 und früher: InternetOpenUrl deaktiviert Gopher an Ports unter 1024, mit Ausnahme von Port 70 – dem Gopher-Standardport – und Port 105, die normalerweise für Die Suche nach Namen der Central Services Organization (CSO) verwendet werden.
Nachdem die aufrufende Anwendung das von InternetOpenUrl zurückgegebene HINTERNET-Handle verwendet hat, muss es mit der InternetCloseHandle-Funktion geschlossen werden.
Hinweis Wenn Sie im asynchronen Modus arbeiten (der dwFlags-Parameter von InternetOpen gibt INTERNET_FLAG_ASYNC an), und der dwContext-Parameter ist Null (INTERNET_NO_CALLBACK), wird der Rückruffunktionssatz mit InternetSetStatusCallback für das Sitzungshandle nicht aufgerufen. Der Aufruf wird jedoch weiterhin im asynchronen Modus ausgeführt.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.
Hinweis
Der wininet.h-Header definiert InternetOpenUrl 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] |
Zielplattform | Windows |
Kopfzeile | wininet.h |
Bibliothek | Wininet.lib |
DLL | Wininet.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für