GopherFindFirstFileA-Funktion (wininet.h)

Artikel
08/27/2023

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

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 für eine von InternetConnect zurückgegebene Gopher-Sitzung.

[in] lpszLocator

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des zu suchenden Elements enthält. Folgende Möglichkeiten stehen zur Auswahl:

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

[in] lpszSearchString

Zeiger auf einen Puffer, der die zu durchsuchenden Zeichenfolgen enthält, wenn diese Anforderung an einen Indexserver erfolgt. Andernfalls sollte dieser Parameter NULL sein.

[out] lpFindData

Zeiger auf eine GOPHER_FIND_DATA-Struktur , die die von dieser Funktion abgerufenen Informationen empfängt.

[in] dwFlags

Steuert das Funktionsverhalten. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

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 den von der Anwendung definierten Wert enthält, der diese Suche allen Anwendungsdaten zuordnet.

Rückgabewert

Gibt bei erfolgreicher Ausführung ein gültiges Suchhandle zurück, andernfalls NULL . Rufen Sie GetLastError oder InternetGetLastResponseInfo auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

GopherFindFirstFile ähnelt der FindFirstFile-Funktion . Es erstellt eine Verbindung mit einem Gopher-Server und gibt dann eine einzelne Struktur zurück, die Informationen zum ersten Gopher-Objekt enthält, auf das von der Locatorzeichenfolge verwiesen wird.

Nach dem Aufrufen von 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 das von GopherFindFirstFile 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 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


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