GopherCreateLocatorA-Funktion (wininet.h)

Artikel
08/27/2023

[Die GopherCreateLocator-Funktion ist für die Verwendung in den betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind.]

Erstellt eine Gopher- oder Gopher+-Locatorzeichenfolge aus den Komponententeilen der Selektorzeichenfolge.

Syntax

BOOL GopherCreateLocatorA(
  [in]      LPCSTR        lpszHost,
  [in]      INTERNET_PORT nServerPort,
  [in]      LPCSTR        lpszDisplayString,
  [in]      LPCSTR        lpszSelectorString,
  [in]      DWORD         dwGopherType,
  [out]     LPSTR         lpszLocator,
  [in, out] LPDWORD       lpdwBufferLength
);

Parameter

[in] lpszHost

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Hosts enthält, oder auf eine gepunktete dezimale IP-Adresse (z. B. 198.105.232.1).

[in] nServerPort

Portnummer, auf der sich der Gopher-Server bei lpszHost in Hostbytereihenfolge befindet. Wenn nServerPortINTERNET_INVALID_PORT_NUMBER ist, wird der Standardmäßige Gopher-Port verwendet.

[in] lpszDisplayString

Zeiger auf eine NULL-endende Zeichenfolge, die das anzuzeigende Gopher-Dokument oder -Verzeichnis enthält. Wenn dieser Parameter NULL ist, gibt die Funktion das Standardverzeichnis für den Gopher-Server zurück.

[in] lpszSelectorString

Zeiger auf die Selektorzeichenfolge, die an den Gopher-Server gesendet werden soll, um Informationen abzurufen. Dieser Parameter kann NULL sein.

[in] dwGopherType

Bestimmt, ob lpszSelectorString auf ein Verzeichnis oder Dokument verweist und ob die Anforderung Gopher+ oder Gopher ist. Der Standardwert GOPHER_TYPE_DIRECTORY wird verwendet, wenn der Wert von dwGopherType null ist. Dies kann einer der Werte des Gophertyps sein.

[out] lpszLocator

Zeiger auf einen Puffer, der die Locatorzeichenfolge empfängt. Wenn lpszLocatorNULL ist, erhält lpdwBufferLength die erforderliche Pufferlänge, aber die Funktion führt keine andere Verarbeitung aus.

[in, out] lpdwBufferLength

Zeiger auf eine Variable, die die Länge des lpszLocator-Puffers in Zeichen enthält. Wenn die Funktion zurückgibt, empfängt dieser Parameter die Anzahl der Zeichen, die in den Puffer geschrieben werden. Wenn GetLastErrorERROR_INSUFFICIENT_BUFFER zurückgibt, empfängt dieser Parameter die erforderliche Anzahl von Zeichen.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE . Rufen Sie GetLastError oder InternetGetLastResponseInfo auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Um Informationen von einem Gopher-Server abzurufen, muss eine Anwendung zunächst einen Gopher-Locator vom Gopher-Server abrufen.

Der Locator, den die Anwendung als undurchsichtiges Token behandeln sollte, wird normalerweise für Aufrufe der GopherFindFirstFile-Funktion verwendet, um eine bestimmte Information abzurufen.

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