GopherGetAttributeA-Funktion (wininet.h)

Artikel
08/27/2023

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

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

Behandeln Sie eine Gopher-Sitzung, die von InternetConnect zurückgegeben wird.

[in] lpszLocator

Zeiger auf eine NULL-beendete Zeichenfolge, die das Element auf dem Gopher-Server identifiziert, auf dem Attributinformationen zurückgegeben werden sollen.

[in] lpszAttributeName

Zeiger auf eine leerzeichentrennende 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

Zeiger auf eine Variable, die die Anzahl der Zeichen enthält, die in den lpBuffer-Puffer eingelesen werden.

[in] lpfnEnumerator

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

Die Rückruffunktion empfängt bei jedem Aufruf die Adresse einer einzelnen GOPHER_ATTRIBUTE_TYPE-Struktur . Mit der Enumerationsrückruffunktion kann die Anwendung vermeiden, dass die Gopher-Attributinformationen analysiert werden müssen.

[in] dwContext

Anwendungsdefinierter Wert, der diesen Vorgang allen Anwendungsdaten ordnet.

Rückgabewert

Gibt TRUE zurück, wenn die Anforderung erfüllt ist, oder andernfalls FALSE . Um erweiterte Fehlerinformationen abzurufen, rufen Sie GetLastError oder InternetGetLastResponseInfo auf.

Hinweise

Im Allgemeinen rufen Anwendungen diese Funktion nach dem Aufruf von GopherFindFirstFile oder InternetFindNextFile auf.

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

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 aus verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

Hinweis

Der wininet.h-Header definiert GopherGetAttribute als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
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

Freigeben über