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