Funzione GopherCreateLocatorA (wininet.h)

Articolo
11/20/2024

[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 un nullstringa con terminazione contenente il nome dell'host o un indirizzo IP punteggiato-decimale (ad esempio 198.105.232.1).

[in] nServerPort

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

[in] lpszDisplayString

Puntatore a un nullstringa con terminazione 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 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 della lpszLocator buffer, in caratteri. Quando la funzione termina, 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 in caso di esito positivo oppure FALSE in caso contrario. Per ottenere informazioni estese sull'errore, chiamare GetLastError o InternetGetLastResponseInfo.

Osservazioni

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 al 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 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 GopherCreateLocator 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