GopherGetAttributeA-Funktion (wininet.h)

Artikel
11/20/2024

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

Ruft die spezifischen Attributinformationen vom Server ab.

Syntax

BOOL GopherGetAttributeA(
  [in]  HINTERNET                   hConnect,
  [in]  LPCSTR                      lpszLocator,
  [in]  LPCSTR                      lpszAttributeName,
  [out] LPBYTE                      lpBuffer,
  [in]  DWORD                       dwBufferLength,
  [out] LPDWORD                     lpdwCharactersReturned,
  [in]  GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator,
  [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 das Element auf dem Gopher-Server identifiziert, auf dem Attributinformationen zurückgegeben werden sollen.

[in] lpszAttributeName

Zeigen Sie auf eine durch Leerzeichen getrennte Zeichenfolge, die die Namen der zurückzugebenden Attribute angibt. Wenn lpszAttributeNameNULL-ist, gibt GopherGetAttribute Informationen zu allen Attributen zurück.

[out] lpBuffer

Zeiger auf einen anwendungsdefinierten Puffer, aus dem Attributinformationen abgerufen werden.

[in] dwBufferLength

Größe des lpBuffer- Puffers in TCHARs.

[out] lpdwCharactersReturned

Zeigen Sie auf eine Variable, die die Anzahl von Zeichen enthält, die in den lpBuffer- Puffer gelesen werden.

[in] lpfnEnumerator

Zeiger auf eine GopherAttributeEnumerator Rückruffunktion, die jedes Attribut des Locators aufzählt. Dieser Parameter ist optional. Wenn es NULL-ist, werden alle Gopher-Attributinformationen in lpBuffer-platziert. Wenn lpfnEnumerator angegeben wird, wird die Rückruffunktion für jedes Attribut des Objekts einmal aufgerufen.

Die Rückruffunktion empfängt die Adresse einer einzelnen GOPHER_ATTRIBUTE_TYPE Struktur mit jedem Aufruf. Mit der Enumerationsrückruffunktion kann die Anwendung vermeiden, die Gopher-Attributinformationen zu analysieren.

[in] dwContext

Anwendungsdefinierter Wert, der diesen Vorgang allen Anwendungsdaten zuordnet.

Rückgabewert

Gibt TRUE zurück, wenn die Anforderung erfüllt ist, oder FALSE andernfalls. Rufen Sie zum Abrufen erweiterter Fehlerinformationen GetLastError- oder InternetGetLastResponseInfo-auf.

Bemerkungen

Im Allgemeinen rufen Anwendungen diese Funktion nach dem Aufrufen GopherFindFirstFile- oder InternetFindNextFile-auf.

Die Größe des lpBuffer--Parameters muss gleich oder größer als der Wert von MIN_GOPHER_ATTRIBUTE_LENGTHsein.

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