GopherFindFirstFileA-Funktion (wininet.h)

Artikel
11/20/2024

[Die GopherFindFirstFile--Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung.]

Verwendet einen Gopher-Locator und Suchkriterien, um eine Sitzung mit dem Server zu erstellen und die angeforderten Dokumente, Binärdateien, Indexserver oder Verzeichnisstrukturen zu suchen.

Syntax

HINTERNET GopherFindFirstFileA(
  [in]  HINTERNET           hConnect,
  [in]  LPCSTR              lpszLocator,
  [in]  LPCSTR              lpszSearchString,
  [out] LPGOPHER_FIND_DATAA lpFindData,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

Parameter

[in] hConnect

Handle to a Gopher session returned by InternetConnect.

[in] lpszLocator

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den Namen des zu suchenden Elements enthält. Dies kann eine der folgenden Sein:

Gopher Locator, der von einem vorherigen Aufruf dieser Funktion oder der InternetFindNextFile--Funktion zurückgegeben wird.
NULL- Zeiger oder leerer Zeichenfolge, die angibt, dass die obersten Informationen von einem Gopher-Server zurückgegeben werden.
Locator, der von der GopherCreateLocator-Funktion erstellt wurde.

[in] lpszSearchString

Zeigen Sie auf einen Puffer, der die zu durchsuchenden Zeichenfolgen enthält, wenn diese Anforderung auf einen Indexserver verweist. Andernfalls sollte dieser Parameter NULL-sein.

[out] lpFindData

Zeigen Sie auf eine GOPHER_FIND_DATA Struktur, die die von dieser Funktion abgerufenen Informationen empfängt.

[in] dwFlags

Steuert das Funktionsverhalten. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.

Wert	Bedeutung
INTERNET_FLAG_HYPERLINK	Erzwingt ein Neuladen, wenn keine Ablaufzeit aufgetreten ist, und keine lastModified-Zeit, die vom Server zurückgegeben wird, 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 zum Cache hinzu.
INTERNET_FLAG_RELOAD	Erzwingt den Download der angeforderten Datei, des Objekts oder des Verzeichniseintrags vom Ursprungsserver, nicht aus dem Cache.
INTERNET_FLAG_RESYNCHRONIZE	Lädt HTTP-Ressourcen neu, wenn die Ressource seit dem letzten Herunterladen geändert wurde. Alle FTP- und Gopher-Ressourcen werden neu geladen.

[in] dwContext

Zeigen Sie auf eine Variable, die den anwendungsdefinierten Wert enthält, der diese Suche allen Anwendungsdaten zuordnet.

Rückgabewert

Gibt ein gültiges Suchhandle zurück, wenn dies erfolgreich ist, oder gibt NULL- andernfalls zurück. Rufen Sie GetLastError oder InternetGetLastResponseInfoauf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

GopherFindFirstFile ähnelt der funktion FindFirstFile. Es erstellt eine Verbindung mit einem Gopher-Server und gibt dann eine einzelne Struktur zurück, die Informationen über das erste Gopher-Objekt enthält, auf das von der Locator-Zeichenfolge verwiesen wird.

Nach dem Aufrufen GopherFindFirstFile- zum Abrufen des ersten Gopher-Objekts in einer Enumeration kann eine Anwendung die InternetFindNextFile--Funktion verwenden, um nachfolgende Gopher-Objekte abzurufen.

Nachdem die aufrufende Anwendung die verwendung des HINTERNET- von GopherFindFirstFile-zurückgegebenen Handle abgeschlossen hat, muss sie mithilfe der InternetCloseHandle--Funktion geschlossen werden.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.

Hinweis WinINet keine Serverimplementierungen unterstützt. Darüber hinaus sollte sie nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder -dienste Microsoft Windows HTTP Services (WinHTTP).

Anmerkung

Der wininet.h-Header definiert GopherFindFirstFile 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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wininet.h
Library	Wininet.lib
DLL-	Wininet.dll

Siehe auch

WinINet-Funktionen

Freigeben über