Función GopherFindFirstFileW (wininet.h)

  • Artículo

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

Usa un localizador de Gopher y criterios de búsqueda para crear una sesión con el servidor y localizar los documentos solicitados, archivos binarios, servidores de índice o árboles de directorio.

Sintaxis

HINTERNET GopherFindFirstFileW(
  [in]  HINTERNET           hConnect,
  [in]  LPCWSTR             lpszLocator,
  [in]  LPCWSTR             lpszSearchString,
  [out] LPGOPHER_FIND_DATAW lpFindData,
  [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 contiene el nombre del elemento que se va a buscar. Este puede ser uno de los siguientes:

  • Localizador gopher devuelto por una llamada anterior a esta función o a la función InternetFindNextFile .
  • Puntero NULL o cadena vacía que indica que se devuelve la información más alta de un servidor Gopher.
  • Localizador creado por la función GopherCreateLocator .

[in] lpszSearchString

Puntero a un búfer que contiene las cadenas que se van a buscar, si esta solicitud es a un servidor de índices. De lo contrario, este parámetro debe ser NULL.

[out] lpFindData

Puntero a una estructura de GOPHER_FIND_DATA que recibe la información recuperada por esta función.

[in] dwFlags

Controla el comportamiento de la función. Este parámetro puede ser una combinación de los valores siguientes.

Value 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ó. Se vuelven a cargar todos los recursos FTP y Gopher.

[in] dwContext

Puntero a una variable que contiene el valor definido por la aplicación que asocia esta búsqueda a los datos de la aplicación.

Valor devuelto

Devuelve un identificador de búsqueda válido si es correcto o NULL de lo contrario. Para recuperar información de error extendida, llame a GetLastError o InternetGetLastResponseInfo.

Comentarios

GopherFindFirstFile se parece mucho a la función FindFirstFile . Crea una conexión con un servidor Gopher y, a continuación, devuelve una única estructura que contiene información sobre el primer objeto gopher al que hace referencia la cadena de localizador.

Después de llamar a GopherFindFirstFile para recuperar el primer objeto Gopher en una enumeración, una aplicación puede usar la función InternetFindNextFile para recuperar los objetos Gopher posteriores.

Una vez finalizada la aplicación que realiza la llamada mediante el identificador HINTERNET devuelto por GopherFindFirstFile, 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 los servicios HTTP de Microsoft Windows (WinHTTP).
 

Nota

El encabezado wininet.h define GopherFindFirstFile 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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