Classe CGopherLocator

Ottiene un "localizzatore" gopher da un server gopher, determina il tipo del localizzatore e rende il localizzatore disponibile per CGopherFileFind.

Nota

Le classi CGopherConnection, CGopherFile, CGopherFileFinde CGopherLocator i relativi membri sono stati deprecati perché non funzionano sulla piattaforma Windows XP, ma continueranno a funzionare su piattaforme precedenti.

Sintassi

class CGopherLocator : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CGopherLocator::CGopherLocator	Costruisce un oggetto CGopherLocator.

Metodi pubblici

Nome	Descrizione
CGopherLocator::GetLocatorType	Analizza un localizzatore gopher e ne determina gli attributi.

Operatori pubblici

Nome	Descrizione
CGopherLocator::operator LPCTSTR	Accede direttamente ai caratteri archiviati in un CGopherLocator oggetto come stringa di tipo C.

Osservazioni:

Un'applicazione deve ottenere il localizzatore di un server gopher prima di poter recuperare informazioni da tale server. Dopo aver ottenuto il localizzatore, deve considerare il localizzatore come token opaco.

Ogni localizzatore gopher ha attributi che determinano il tipo di file o server trovato. Per un elenco dei tipi di localizzatori gopher, vedere GetLocatorType .

Un'applicazione usa in genere il localizzatore per le chiamate a CGopherFileFind::FindFile per recuperare un'informazione specifica.

Per altre informazioni sul CGopherLocator funzionamento delle altre classi Internet MFC, vedere l'articolo Programmazione Internet con WinInet.

Gerarchia di ereditarietà

CObject

CGopherLocator

Requisiti

Intestazione: afxinet.h

CGopherLocator::CGopherLocator

Questa funzione membro viene chiamata per creare un CGopherLocator oggetto .

CGopherLocator(const CGopherLocator& ref);

Parametri

ref
Riferimento a un oggetto costante CGopherLocator .

Osservazioni:

Non si crea mai direttamente un CGopherLocator oggetto. Chiamare invece CGopherConnection::CreateLocator per creare e restituire un puntatore all'oggetto CGopherLocator .

CGopherLocator::GetLocatorType

Chiamare questa funzione membro per ottenere il tipo di localizzatore.

BOOL GetLocatorType(DWORD& dwRef) const;

Parametri

dwRef
Riferimento a un DWORD che riceverà il tipo di localizzatore. Per una tabella di tipi di localizzatore, vedere La sezione Osservazioni.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0. Se la chiamata non riesce, è possibile chiamare la funzione Win32 GetLastError per determinare la causa dell'errore.

Osservazioni:

I tipi possibili sono i seguenti:

Valore	Significato
GOPHER_TYPE_TEXT_FILE	Un file di testo ASCII.
GOPHER_TYPE_DIRECTORY	Directory di elementi gopher aggiuntivi.
GOPHER_TYPE_CSO	Un server di rubrica CSO.
GOPHER_TYPE_ERROR	Indica una condizione di errore.
GOPHER_TYPE_MAC_BINHEX	Un file Macintosh in formato BINHEX.
GOPHER_TYPE_DOS_ARCHIVE	Un file di archivio DOS.
GOPHER_TYPE_UNIX_UUENCODED	Un file UUENCODED.
GOPHER_TYPE_INDEX_SERVER	Un server di indicizzazione.
GOPHER_TYPE_TELNET	Un server Telnet.
GOPHER_TYPE_BINARY	File binario.
GOPHER_TYPE_REDUNDANT	Server duplicato. Le informazioni contenute in sono un duplicato del server primario. Il server primario è l'ultima voce di directory che non ha un tipo di GOPHER_TYPE_REDUNDANT.
GOPHER_TYPE_TN3270	Un server TN3270.
GOPHER_TYPE_GIF	Un file di grafica GIF.
GOPHER_TYPE_IMAGE	Un file di immagine.
GOPHER_TYPE_BITMAP	Un file bitmap.
GOPHER_TYPE_MOVIE	Un file di film.
GOPHER_TYPE_SOUND	Un file audio.
GOPHER_TYPE_HTML	Documento HTML.
GOPHER_TYPE_PDF	Un file PDF.
GOPHER_TYPE_CALENDAR	Un file di calendario.
GOPHER_TYPE_INLINE	File inline.
GOPHER_TYPE_UNKNOWN	Il tipo di elemento è sconosciuto.
GOPHER_TYPE_ASK	Elemento Ask+.
GOPHER_TYPE_GOPHER_PLUS	Elemento Gopher+.

CGopherLocator::operator LPCTSTR

Questo operatore di cast utile fornisce un metodo efficiente per accedere alla stringa C con terminazione Null contenuta in un CGopherLocator oggetto .

operator LPCTSTR () const;

Valore restituito

Puntatore di caratteri ai dati della stringa.

Osservazioni:

Non vengono copiati caratteri; viene restituito solo un puntatore.

Vedi anche

Classe CObject
Grafico della gerarchia
Classe CGopherFileFind