GopherOpenFileW-Funktion (wininet.h)
[Die GopherOpenFile-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind.]
Beginnt mit dem Lesen einer Gopher-Datendatei von einem Gopher-Server.
Syntax
HINTERNET GopherOpenFileW(
[in] HINTERNET hConnect,
[in] LPCWSTR lpszLocator,
[in] LPCWSTR lpszView,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
Parameter
[in] hConnect
Behandeln Sie eine Gopher-Sitzung, die von InternetConnect zurückgegeben wird.
[in] lpszLocator
Zeiger auf eine NULL-Zeichenfolge, die die zu öffnende Datei angibt. Im Allgemeinen wird dieser Locator von einem Aufruf von GopherFindFirstFile oder InternetFindNextFile zurückgegeben. Da das Gopher-Protokoll kein Konzept für ein aktuelles Verzeichnis hat, ist der Locator immer voll qualifiziert.
[in] lpszView
Zeiger auf eine NULL-Zeichenfolge, die die zu öffnende Ansicht beschreibt, wenn mehrere Ansichten der Datei auf dem Server vorhanden sind. Wenn lpszViewNULL ist, verwendet die Funktion die Standarddateiansicht.
[in] dwFlags
Bedingungen, unter denen nachfolgende Übertragungen erfolgen. Bei diesem Parameter kann es sich um einen der folgenden Werte handeln.
Wert | Bedeutung |
---|---|
|
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. |
|
Bewirkt, dass eine temporäre Datei erstellt wird, wenn die Datei nicht zwischengespeichert werden kann. |
|
Fügt die zurückgegebene Entität nicht dem Cache hinzu. |
|
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- und Gopher-Ressourcen werden neu geladen. |
[in] dwContext
Zeiger auf eine Variable, die einen von der Anwendung definierten Wert enthält, der diesen Vorgang allen Anwendungsdaten ordnet.
Rückgabewert
Gibt bei erfolgreicher Ausführung ein Handle oder NULL zurück, wenn die Datei nicht geöffnet werden kann. Um erweiterte Fehlerinformationen abzurufen, rufen Sie GetLastError oder InternetGetLastResponseInfo auf.
Hinweise
GopherOpenFile öffnet eine Datei auf einem Gopher-Server. Da eine Datei auf einem Server nicht tatsächlich geöffnet oder gesperrt werden kann, ordnet diese Funktion einfach Standortinformationen einem Handle zu, das eine Anwendung für dateibasierte Vorgänge wie InternetReadFile oder GopherGetAttribute verwenden kann.
Nachdem die aufrufende Anwendung das von GopherOpenFile zurückgegebene HINTERNET-Handle verwendet hat, muss es mit der InternetCloseHandle-Funktion geschlossen werden.
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 GopherOpenFile 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 |