GopherOpenFileA-Funktion (wininet.h)

Artikel
08/27/2023

[Die GopherOpenFile-Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar.]

Beginnt mit dem Lesen einer Gopher-Datendatei von einem Gopher-Server.

Syntax

HINTERNET GopherOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocator,
  [in] LPCSTR    lpszView,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Parameter

[in] hConnect

Handle für eine von InternetConnect zurückgegebene Gopher-Sitzung.

[in] lpszLocator

Zeiger auf eine NULL-endende 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 eines aktuellen Verzeichnisses hat, ist der Locator immer voll qualifiziert.

[in] lpszView

Zeiger auf eine NULL-endende 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
INTERNET_FLAG_HYPERLINK	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.
INTERNET_FLAG_NEED_FILE	Bewirkt, dass eine temporäre Datei erstellt wird, wenn die Datei nicht zwischengespeichert werden kann.
INTERNET_FLAG_NO_CACHE_WRITE	Fügt die zurückgegebene Entität nicht dem Cache hinzu.
INTERNET_FLAG_RELOAD	Erzwingt einen Download der angeforderten Datei, des angeforderten Objekts oder der angeforderten Verzeichnisliste vom ursprünglichen Server, nicht aus dem Cache.
INTERNET_FLAG_RESYNCHRONIZE	Lädt HTTP-Ressourcen neu, wenn die Ressource seit dem letzten Download geändert wurde. Alle FTP- und Gopher-Ressourcen werden erneut geladen.

[in] dwContext

Zeiger auf eine Variable, die einen anwendungsdefinierten Wert enthält, der diesen Vorgang allen Anwendungsdaten zuordnet.

Rückgabewert

Gibt bei erfolgreicher Ausführung ein Handle oder NULL zurück, wenn die Datei nicht geöffnet werden kann. Rufen Sie GetLastError oder InternetGetLastResponseInfo auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

GopherOpenFile öffnet eine Datei auf einem Gopher-Server. Da eine Datei nicht tatsächlich auf einem Server 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 sie 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 WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

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 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


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

WinINet-Funktionen

Share via