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à
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