Función GopherOpenFileA (wininet.h)

[La función GopherOpenFile está disponible para su uso en los sistemas operativos especificados en la sección Requisitos.]

Comienza a leer un archivo de datos de Gopher desde un servidor de Gopher.

Sintaxis

HINTERNET GopherOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocator,
  [in] LPCSTR    lpszView,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Parámetros

[in] hConnect

Identificador de una sesión de Gopher devuelta por InternetConnect.

[in] lpszLocator

Puntero a un cadena terminada en nullque especifica el archivo que se va a abrir. Por lo general, este localizador se devuelve desde una llamada a GopherFindFirstFile o InternetFindNextFile. Dado que el protocolo Gopher no tiene ningún concepto de directorio actual, el localizador siempre está completo.

[in] lpszView

Puntero a un cadena terminada en nullque describe la vista para abrir si existen varias vistas del archivo en el servidor. Si lpszView es NULL, la función usa la vista de archivo predeterminada.

[in] dwFlags

Condiciones en las que se producen las transferencias posteriores. Este parámetro puede ser cualquiera de los siguientes valores.

Valor	Significado
INTERNET_FLAG_HYPERLINK	Fuerza una recarga si no había ninguna hora de expiración y no se devolvió la hora lastModified del servidor al determinar si se debe volver a cargar el elemento de la red.
INTERNET_FLAG_NEED_FILE	Hace que se cree un archivo temporal si el archivo no se puede almacenar en caché.
INTERNET_FLAG_NO_CACHE_WRITE	No agrega la entidad devuelta a la memoria caché.
INTERNET_FLAG_RELOAD	Fuerza una descarga del archivo, el objeto o la lista de directorios solicitados desde el servidor de origen, no desde la memoria caché.
INTERNET_FLAG_RESYNCHRONIZE	Recarga los recursos HTTP si el recurso se ha modificado desde la última vez que se descargó. Todos los recursos FTP y Gopher se vuelven a cargar.

[in] dwContext

Puntero a una variable que contiene un valor definido por la aplicación que asocia esta operación a los datos de la aplicación.

Valor devuelto

Devuelve un identificador si se ejecuta correctamente o NULL si no se puede abrir el archivo. Para recuperar información de error extendida, llame a GetLastError o InternetGetLastResponseInfo.

Observaciones

gopherOpenFile abre un archivo en un servidor gopher. Dado que un archivo realmente no se puede abrir o bloquear en un servidor, esta función simplemente asocia información de ubicación con un identificador que una aplicación puede usar para operaciones basadas en archivos, como InternetReadFile o GopherGetAttribute.

Después de que la aplicación que realiza la llamada haya terminado de usar el identificador de HINTERNET devuelto por GopherOpenFile, debe cerrarse mediante la función InternetCloseHandle.

Al igual que todos los demás aspectos de la API de WinINet, esta función no se puede llamar de forma segura desde DllMain ni desde los constructores y destructores de objetos globales.

Nota WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use Servicios HTTP de Microsoft Windows (WinHTTP).

 

Nota

El encabezado wininet.h define GopherOpenFile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wininet.h
biblioteca de	Wininet.lib
DLL de	Wininet.dll

Consulte también

funciones winINet