Classe CGopherLocator
Obtém um "localizador" gopher de um servidor gopher, determina o tipo do localizador e disponibiliza o localizador para CGopherFileFind.
Observação
As classes CGopherConnection, CGopherFile, CGopherFileFind, CGopherLocator e seus membros foram preteridos porque não funcionam na plataforma Windows XP, mas continuarão a funcionar em plataformas anteriores.
Sintaxe
class CGopherLocator : public CObject
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CGopherLocator::CGopherLocator | Constrói um objeto CGopherLocator. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CGopherLocator::GetLocatorType | Analisa um localizador gopher e determina seus atributos. |
Operadores públicos
| Nome | Descrição |
|---|---|
| CGopherLocator::operator LPCTSTR | Acessa diretamente caracteres armazenados em um objeto CGopherLocator como uma cadeia de caracteres no estilo C. |
Comentários
Um aplicativo deve obter o localizador de um servidor gopher para poder recuperar informações desse servidor. Quando tiver o localizador, ele deverá tratar o localizador como um token opaco.
Cada localizador gopher tem atributos que determinam o tipo de arquivo ou servidor encontrado. Consulte GetLocatorType para obter uma lista de tipos de localizadores gopher.
Um aplicativo normalmente usa o localizador para chamadas para CGopherFileFind::FindFile para recuperar uma informação específica.
Para saber mais sobre como CGopherLocator funciona com as outras classes de Internet do MFC, confira o artigo Programação na Internet com o WinInet.
Hierarquia de herança
CGopherLocator
Requisitos
Cabeçalho: afxinet.h
CGopherLocator::CGopherLocator
Essa função membro é chamada para criar um objeto CGopherLocator.
CGopherLocator(const CGopherLocator& ref);
Parâmetros
ref
Uma referência a um objeto CGopherLocator constante.
Comentários
Você nunca cria um objeto CGopherLocator diretamente. Em vez disso, chame CGopherConnection::CreateLocator para criar e retornar um ponteiro para o objeto CGopherLocator.
CGopherLocator::GetLocatorType
Chame essa função membro para obter o tipo de localizador.
BOOL GetLocatorType(DWORD& dwRef) const;
Parâmetros
dwRef
Uma referência a um DWORD que receberá o tipo de localizador. Consulte Comentários para obter uma tabela de tipos de localizador.
Valor de retorno
Diferente de zero se tiver êxito; caso contrário, 0. Se a chamada falhar, a função Win32 GetLastError poderá ser chamada para determinar a causa do erro.
Comentários
Os tipos possíveis são os seguintes:
| Valor | Significado |
|---|---|
| GOPHER_TYPE_TEXT_FILE | Um arquivo de texto ASCII. |
| GOPHER_TYPE_DIRECTORY | Um diretório de itens adicionais do Gopher. |
| GOPHER_TYPE_CSO | Um servidor de agenda telefônica CSO. |
| GOPHER_TYPE_ERROR | Indica uma condição de erro. |
| GOPHER_TYPE_MAC_BINHEX | Um arquivo Macintosh no formato BINHEX. |
| GOPHER_TYPE_DOS_ARCHIVE | Um arquivo DOS. |
| GOPHER_TYPE_UNIX_UUENCODED | Um arquivo UUENCODED. |
| GOPHER_TYPE_INDEX_SERVER | Um servidor de índice. |
| GOPHER_TYPE_TELNET | Um servidor Telnet. |
| GOPHER_TYPE_BINARY | Um arquivo binário. |
| GOPHER_TYPE_REDUNDANT | Um servidor duplicado. As informações contidas dentro são uma duplicata do servidor primário. O servidor primário é a última entrada de diretório que não tinha um tipo GOPHER_TYPE_REDUNDANT. |
| GOPHER_TYPE_TN3270 | Um servidor TN3270. |
| GOPHER_TYPE_GIF | Um arquivo gráfico GIF. |
| GOPHER_TYPE_IMAGE | Um arquivo de imagem. |
| GOPHER_TYPE_BITMAP | Um arquivo bitmap. |
| GOPHER_TYPE_MOVIE | Um arquivo de filme. |
| GOPHER_TYPE_SOUND | Um arquivo de som. |
| GOPHER_TYPE_HTML | Um documento HTML. |
| GOPHER_TYPE_PDF | Um arquivo PDF. |
| GOPHER_TYPE_CALENDAR | Um arquivo de calendário. |
| GOPHER_TYPE_INLINE | Um arquivo embutido. |
| GOPHER_TYPE_UNKNOWN | O tipo de item é desconhecido. |
| GOPHER_TYPE_ASK | Um item Ask+. |
| GOPHER_TYPE_GOPHER_PLUS | Um item Gopher+. |
CGopherLocator::operator LPCTSTR
Esse operador de conversão útil fornece um método eficiente para acessar a cadeia de caracteres C terminada em nulo contida em um objeto CGopherLocator.
operator LPCTSTR () const;
Valor de retorno
Um ponteiro de caractere para os dados da cadeia de caracteres.
Comentários
Nenhum caractere é copiado. Apenas um ponteiro é retornado.