Funzione GopherGetAttributeA (wininet.h)

Articolo
03/04/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 una stringa con terminazione Null 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 lpBuffer , in TCHAR.

[out] lpdwCharactersReturned

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

[in] lpfnEnumerator

Puntatore a una funzione di callback GopherAttributeEnumerator che enumera ogni attributo del localizzatore. Questo parametro è facoltativo e, 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.

Commenti

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 da 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 i 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wininet.h
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

Funzioni WinINet

Condividi tramite