GopherGetAttributeA-Funktion (wininet.h)

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

Anforderungen

Siehe auch

WinINet-Funktionen