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

CObject

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)