CInternetSession::OpenURL

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um die angegebene Anforderung an den HTTP-Server zu senden und dem Client zu ermöglichen, um zusätzliche RFC822-, MIME- oder HTTP-Header anzugeben, die zusammen mit der Anforderung gesendet werden.

CStdioFile* OpenURL(
   LPCTSTR pstrURL,
   DWORD_PTR dwContext = 1,
   DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII,
   LPCTSTR pstrHeaders = NULL,
   DWORD dwHeadersLength = 0 
);

Parameter

pstrURL
Ein Zeiger auf den Namen der URL, um von Lesen zu starten.Nur URL, die mit file:, ftp:, gopher: oder HTTP beginnt: werden unterstützt.ASSERTS, wenn pszURLNULL ist.
dwContext
Ein Anwendung festgelegten Wert übergeben mit dem zurückgegebenen Handle im Rückruf.
dwFlags
Die Flags, die wie diese Verbindung beschreiben, behandelt.Siehe Remarks weitere Informationen über die gültigen Flags.Gültige Flags sind:
- INTERNET_FLAG_TRANSFER_ASCII standardmäßig.Übertragen Sie die Datei als ASCII-Text.
- INTERNET_FLAG_TRANSFER_BINARY Übertragung die Datei als Binärdatei.
- INTERNET_FLAG_RELOAD rufen die Daten der Verbindung ab, auch wenn es lokal zwischengespeichert wird.
- INTERNET_FLAG_DONT_CACHE zwischenspeichern, die Daten entweder nicht lokal noch in einem Gateways.
- INTERNET_FLAG_SECURE dieses Flag ist nur für HTTP-Anforderungen anwendbar.Es fordert sichere Transaktionen auf die Verbindung mit Secure Sockets Layer oder PCT.
- INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT, wenn möglich, verwenden die vorhandenen Verbindungen mit dem Server für die neuen Anforderungen erneut, die von OpenUrl generiert werden, anstatt eine neue Sitzung für jede Aufforderung zum Aufbau einer Verbindung zu erstellen.
- INTERNET_FLAG_PASSIVE verwendete für eine FTP-Site.Wird passive FTP-Semantik.Wird mit CInternetConnection von OpenURL.
pstrHeaders
Ein Zeiger auf eine Zeichenfolge, die die dem HTTP-Server gesendet werden, Header enthält.
dwHeadersLength
Die Länge, in Zeichen, der zusätzlichen Header.Wenn dieses -1L ist und pstrHeaders Nicht --NULL ist, wird pstrHeaders angenommen, dass null sein beendet und die Länge wird berechnet.

Rückgabewert

Gibt ein Dateihandle nur für FTP, GOPHER, HTTP und Dateityp-Internetdienste zurück.Gibt NULL zurück, wenn das Analysieren nicht erfolgreich war.

Der Zeiger, den OpenURL zurückgibt, hängt vom Typ der pszURLs des Diensts ab.Die folgende Tabelle zeigt die möglichen Zeiger, die OpenURL zurückgeben kann.

URL-Typ	Rückgabewerte
file://	CStdioFile*
http://	CHttpFile*
gopher://	CGopherFile*
ftp://	CInternetFile*

Hinweise

Der Parameter dwFlags muss entweder INTERNET_FLAG_TRANSFER_ASCII oder INTERNET_FLAG_TRANSFER_BINARY, aber nicht beides.Die verbleibenden Flags können mit dem bitweisen Operator kombiniert werden ( OR**|**).

OpenURL, die die Win32-Funktion InternetOpenURL umschließt, können die Daten von einem Internetserver nur herunterladen, abrufen und lesen.OpenURL können keine Dateimanipulation auf einem Remotespeicherort, daher erfordert er kein CInternetConnection-Objekt.

Um verbindungsspezifische (das heißt, protokollspezifische) Funktionen, wie das Schreiben in eine Datei zu verwenden, müssen Sie eine Sitzung öffnen, dann öffnen eine bestimmte Art von Verbindung, dann anhand dieser Verbindung eine Datei im gewünschten Modus zu öffnen.Siehe CInternetConnection weitere Informationen über spezielle Funktionen.