Funzione GopherGetAttributeA (wininet.h)
[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
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 |