InternetOpenUrlA-Funktion (wininet.h)

Öffnet eine Ressource, die durch eine vollständige FTP- oder HTTP-URL angegeben wird.

Syntax

HINTERNET InternetOpenUrlA(
  [in] HINTERNET hInternet,
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    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-endende Zeichenfolgenvariable, die die URL angibt, die mit dem Lesen beginnen soll. Es werden nur URLs unterstützt, die mit ftp:, http: oder https: beginnen.

[in] lpszHeaders

Ein Zeiger auf eine NULL-endende 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 und lpszHeaders nicht NULL ist, wird davon ausgegangen, dass lpszHeaders null-terminated (ASCIIZ) ist, und die Länge wird berechnet.

[in] dwFlags

Dieser Parameter kann einen der folgenden Werte annehmen.

[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. Rufen Sie GetLastError auf, um eine bestimmte Fehlermeldung abzurufen. 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 jedes der Protokolle abzurufen, die WinINet unterstützt. 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, die kleiner als 1024 sind, mit Ausnahme von Port 70 – dem Standardmäßigen Gopher-Port – und Port 105, der normalerweise für CSO-Namenssuchen (Central Services Organization) verwendet wird.

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 null (INTERNET_NO_CALLBACK) ist, wird die mit InternetSetStatusCallback für das Sitzungshandle festgelegte Rückruffunktion 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.

Anforderungen

Weitere Informationen

Behandeln von Uniform Resource Locators

WinINet-Funktionen