Funzione GopherGetAttributeA (wininet.h)

Articolo
11/20/2024

[La funzione GopherGetAttribute è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti.]

Recupera le informazioni specifiche sull'attributo dal server.

Sintassi

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
);

Parametri

[in] hConnect

Handle in una sessione Gopher restituita da InternetConnect.

[in] lpszLocator

Puntatore a un nullstringa con terminazione che identifica l'elemento nel server Gopher in cui restituire informazioni sull'attributo.

[in] lpszAttributeName

Puntatore a una stringa delimitata da spazi che specifica i nomi degli attributi da restituire. Se lpszAttributeName è NULL, GopherGetAttribute restituisce informazioni su tutti gli attributi.

[out] lpBuffer

Puntatore a un buffer definito dall'applicazione da cui vengono recuperate le informazioni sugli attributi.

[in] dwBufferLength

Dimensioni del buffer di lpBuffer , in TCHARs.

[out] lpdwCharactersReturned

Puntatore a una variabile contenente il numero di caratteri letti nel buffer lpBuffer.

[in] lpfnEnumerator

Puntatore a un GopherAttributeEnumerator funzione di callback che enumera ogni attributo del localizzatore. Questo parametro è facoltativo. Se è null, tutte le informazioni sull'attributo Gopher vengono inserite in lpBuffer. Se viene specificato lpfnEnumerator, la funzione di callback viene chiamata una volta per ogni attributo dell'oggetto.

La funzione di callback riceve l'indirizzo di una singola struttura GOPHER_ATTRIBUTE_TYPE con ogni chiamata. La funzione di callback di enumerazione consente all'applicazione di evitare di dover analizzare le informazioni sull'attributo Gopher.

[in] dwContext

Valore definito dall'applicazione che associa questa operazione a tutti i dati dell'applicazione.

Valore restituito

Restituisce TRUE se la richiesta è soddisfatta o false in caso contrario. Per ottenere informazioni estese sull'errore, chiamare GetLastError o InternetGetLastResponseInfo.

Osservazioni

In genere, le applicazioni chiamano questa funzione dopo aver chiamato GopherFindFirstFile o InternetFindNextFile.

Le dimensioni del parametro lpBuffer devono essere uguali o maggiori del valore di MIN_GOPHER_ATTRIBUTE_LENGTH.

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro dall'interno di DllMain o dai costruttori e distruttori di oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare Servizi HTTP Di Microsoft Windows (WinHTTP).

Nota

L'intestazione wininet.h definisce GopherGetAttribute come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wininet.h
libreria	Wininet.lib
dll	Wininet.dll

Vedere anche

funzioni WinINet

Condividi tramite