Funzione GopherOpenFileA (wininet.h)

  • Articolo

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

Inizia a leggere un file di dati Gopher da un server Gopher.

Sintassi

HINTERNET GopherOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocator,
  [in] LPCSTR    lpszView,
  [in] DWORD     dwFlags,
  [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 specifica il file da aprire. In genere, questo localizzatore viene restituito da una chiamata a GopherFindFirstFile o InternetFindNextFile. Poiché il protocollo Gopher non ha alcun concetto di una directory corrente, il localizzatore è sempre completo.

[in] lpszView

Puntatore a una stringa con terminazione null che descrive la visualizzazione da aprire se esistono diverse visualizzazioni del file nel server. Se lpszView è NULL, la funzione usa la visualizzazione file predefinita.

[in] dwFlags

Condizioni in cui si verificano trasferimenti successivi. Questo parametro può essere uno dei valori seguenti.

Valore Significato
INTERNET_FLAG_HYPERLINK
 Forza un ricaricamento se non era presente un'ora di scadenza e nessun tempo LastModified restituito dal server quando determina se ricaricare l'elemento dalla rete.
INTERNET_FLAG_NEED_FILE
 Causa la creazione di un file temporaneo se il file non può essere memorizzato nella cache.
INTERNET_FLAG_NO_CACHE_WRITE
 Non aggiunge l'entità restituita alla cache.
INTERNET_FLAG_RELOAD
 Impone un download del file, dell'oggetto o dell'elenco di directory richiesto dal server di origine e non dalla cache.
INTERNET_FLAG_RESYNCHRONIZE
 Ricarica le risorse HTTP se la risorsa è stata modificata dall'ultima volta che è stata scaricata. Tutte le risorse FTP e Gopher vengono ricaricate.

[in] dwContext

Puntatore a una variabile contenente un valore definito dall'applicazione che associa questa operazione a qualsiasi dati dell'applicazione.

Valore restituito

Restituisce un handle se ha esito positivo o NULL se il file non può essere aperto. Per recuperare informazioni sull'errore estese, chiamare GetLastError o InternetGetLastResponseInfo.

Commenti

GopherOpenFile apre un file in un server Gopher. Poiché un file non può essere aperto o bloccato in un server, questa funzione associa semplicemente le informazioni sulla posizione a un handle che un'applicazione può usare per operazioni basate su file, ad esempio InternetReadFile o GopherGetAttribute.

Al termine dell'applicazione chiamante, l'handle HINTERNET restituito da GopherOpenFile deve essere chiuso usando la funzione InternetCloseHandle .

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 degli oggetti globali.

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

Nota

L'intestazione wininet.h definisce GopherOpenFile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
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