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 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 |
|---|---|
|
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. |
|
Hace que se cree un archivo temporal si el archivo no se puede almacenar en caché. |
|
No agrega la entidad devuelta a la memoria caché. |
|
Fuerza una descarga del archivo, el objeto o el listado de directorio solicitado del servidor de origen, no de la memoria caché. |
|
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
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 |