Clase CGopherLocator
Obtiene un "localizador" gopher de un servidor gopher, determina el tipo de localizador y lo pone a disposición de CGopherFileFind.
Nota:
Las clases CGopherConnection, CGopherFile, CGopherFileFind, CGopherLocator y sus miembros han quedado en desuso porque no funcionan en la plataforma Windows XP, pero seguirán funcionando en las plataformas anteriores.
Sintaxis
class CGopherLocator : public CObject
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CGopherLocator::CGopherLocator | Construye un objeto CGopherLocator. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CGopherLocator::GetLocatorType | Analiza un localizador gopher y determina sus atributos. |
Operadores públicos
| Nombre | Descripción |
|---|---|
| CGopherLocator::operator LPCTSTR | Accede directamente a los caracteres almacenados en un objeto CGopherLocatorcomo una cadena de estilo C. |
Comentarios
Una aplicación debe obtener el localizador de un servidor gopher para poder recuperar información de ese servidor. Una vez que tenga el localizador, lo debe tratar como un token opaco.
Cada localizador gopher tiene atributos que determinan el tipo de archivo o servidor encontrado. Vea GetLocatorType para obtener una lista de tipos de localizadores gopher.
Normalmente, una aplicación usa el localizador para las llamadas a CGopherFileFind::FindFile a fin de recuperar un fragmento de información específico.
Para obtener más información sobre cómo funciona CGopherLocator con las otras clases de Internet de MFC, vea el artículo Programación de Internet con WinInet.
Jerarquía de herencia
CGopherLocator
Requisitos
Encabezado: afxinet.h
CGopherLocator::CGopherLocator
Se llama a esta función miembro para construir un objeto CGopherLocator.
CGopherLocator(const CGopherLocator& ref);
Parámetros
ref
Referencia a un objeto CGopherLocator constante.
Comentarios
Nunca se crea un CGopherLocator objeto directamente. En su lugar, llame a CGopherConnection::CreateLocator para crear y devolver un puntero al objeto CGopherLocator.
CGopherLocator::GetLocatorType
Llame a esta función miembro para obtener el tipo de localizador.
BOOL GetLocatorType(DWORD& dwRef) const;
Parámetros
dwRef
Referencia a un elemento DWORD que recibirá el tipo de localizador. Vea Comentarios para obtener una tabla de tipos de localizador.
Valor devuelto
Si es correcta, su valor es distinto de cero. En caso contrario, es cero. Si se produce un error en la llamada, se puede llamar a la función GetLastError de Win32 para determinar la causa del error.
Comentarios
Los tipos posibles son los siguientes:
| Valor | Significado |
|---|---|
| GOPHER_TYPE_TEXT_FILE | Archivo de texto ASCII. |
| GOPHER_TYPE_DIRECTORY | Directorio de elementos Gopher adicionales. |
| GOPHER_TYPE_CSO | Servidor de libreta de teléfonos CSO. |
| GOPHER_TYPE_ERROR | Indica una condición de error. |
| GOPHER_TYPE_MAC_BINHEX | Archivo Macintosh en formato BINHEX. |
| GOPHER_TYPE_DOS_ARCHIVE | Archivo de nivel de archivo DOS. |
| GOPHER_TYPE_UNIX_UUENCODED | Archivo UUENCODED. |
| GOPHER_TYPE_INDEX_SERVER | Servidor de índices. |
| GOPHER_TYPE_TELNET | Servidor Telnet. |
| GOPHER_TYPE_BINARY | Archivo binario. |
| GOPHER_TYPE_REDUNDANT | Servidor duplicado. La información incluida dentro es un duplicado del servidor principal. El servidor principal es la última entrada del directorio que no tenía un tipo de GOPHER_TYPE_REDUNDANT. |
| GOPHER_TYPE_TN3270 | Servidor TN3270. |
| GOPHER_TYPE_GIF | Archivo de gráficos GIF. |
| GOPHER_TYPE_IMAGE | Archivo de imagen. |
| GOPHER_TYPE_BITMAP | Archivo de mapa de bits. |
| GOPHER_TYPE_MOVIE | Archivo de película. |
| GOPHER_TYPE_SOUND | Archivo de sonido. |
| GOPHER_TYPE_HTML | Documento HTML. |
| GOPHER_TYPE_PDF | Archivo PDF. |
| GOPHER_TYPE_CALENDAR | Archivo de calendario. |
| GOPHER_TYPE_INLINE | Archivo insertado. |
| GOPHER_TYPE_UNKNOWN | Se desconoce el tipo de elemento. |
| GOPHER_TYPE_ASK | Elemento Ask+. |
| GOPHER_TYPE_GOPHER_PLUS | Elemento Gopher+. |
CGopherLocator::operator LPCTSTR
Este operador de conversión útil proporciona un método eficaz para acceder a la cadena de C terminada en null incluida en un objeto CGopherLocator.
operator LPCTSTR () const;
Valor devuelto
Puntero de caracteres a los datos de la cadena.
Comentarios
No se copian caracteres; solo se devuelve un puntero.
Consulte también
CObject (clase)
Gráfico de jerarquías
CGopherFileFind (clase)