Función GopherOpenFileA (wininet.h)

  • Artículo

[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 gopher desde un servidor 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 una cadena terminada en null que 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 una cadena terminada en null que 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 transferencias posteriores. Este parámetro puede ser cualquiera de los valores siguientes.

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 el listado de directorio solicitado del servidor de origen, no de la memoria caché.
INTERNET_FLAG_RESYNCHRONIZE
 Vuelve a cargar 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 el archivo no se puede abrir. Para recuperar información de error extendida, llame a GetLastError o InternetGetLastResponseInfo.

Comentarios

GopherOpenFile abre un archivo en un servidor gopher. Dado que un archivo 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 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 Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wininet.h
Library Wininet.lib
Archivo DLL Wininet.dll

Consulte también

Funciones de WinINet