GopherGetAttributeA-Funktion (wininet.h)

[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.

Anforderungen

Weitere Informationen

WinINet-Funktionen