Funzione GopherCreateLocatorA (wininet.h)

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

Crea una stringa del localizzatore Gopher o Gopher+ dalle parti del componente della stringa del selettore.

Sintassi

BOOL GopherCreateLocatorA(
  [in]      LPCSTR        lpszHost,
  [in]      INTERNET_PORT nServerPort,
  [in]      LPCSTR        lpszDisplayString,
  [in]      LPCSTR        lpszSelectorString,
  [in]      DWORD         dwGopherType,
  [out]     LPSTR         lpszLocator,
  [in, out] LPDWORD       lpdwBufferLength
);

Parametri

[in] lpszHost

Puntatore a una stringa con terminazione Null che contiene il nome dell'host o un indirizzo IP con punti decimali (ad esempio 198.105.232.1).

[in] nServerPort

Numero di porta in cui risiede il server Gopher in lpszHost , nell'ordine dei byte host. Se nServerPort è INTERNET_INVALID_PORT_NUMBER, viene usata la porta Gopher predefinita.

[in] lpszDisplayString

Puntatore a una stringa con terminazione Null contenente il documento o la directory Gopher da visualizzare. Se questo parametro è NULL, la funzione restituisce la directory predefinita per il server Gopher.

[in] lpszSelectorString

Puntatore alla stringa del selettore da inviare al server Gopher per recuperare le informazioni. Questo parametro può essere NULL.

[in] dwGopherType

Determina se lpszSelectorString fa riferimento a una directory o a un documento e se la richiesta è Gopher+ o Gopher. Il valore predefinito, GOPHER_TYPE_DIRECTORY, viene usato se il valore di dwGopherType è zero. Può trattarsi di uno dei valori del tipo gopher.

[out] lpszLocator

Puntatore a un buffer che riceve la stringa del localizzatore. Se lpszLocator è NULL, lpdwBufferLength riceve la lunghezza del buffer necessaria, ma la funzione non esegue altre elaborazioni.

[in, out] lpdwBufferLength

Puntatore a una variabile che contiene la lunghezza del buffer lpszLocator , in caratteri. Quando la funzione viene restituita, questo parametro riceve il numero di caratteri scritti nel buffer. Se GetLastError restituisce ERROR_INSUFFICIENT_BUFFER, questo parametro riceve il numero di caratteri necessari.

Valore restituito

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario. Per ottenere informazioni estese sull'errore, chiamare GetLastError o InternetGetLastResponseInfo.

Commenti

Per recuperare informazioni da un server Gopher, un'applicazione deve prima ottenere un "localizzatore" gopher dal server Gopher.

Il localizzatore, che l'applicazione deve considerare come token opaco, viene in genere usato per le chiamate alla funzione GopherFindFirstFile per recuperare una parte specifica di informazioni.

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.

Requisiti

Vedi anche

Funzioni WinINet