Función GopherFindFirstFileA (wininet.h)

Artículo
11/20/2024

[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 GopherFindFirstFileA(
  [in]  HINTERNET           hConnect,
  [in]  LPCSTR              lpszLocator,
  [in]  LPCSTR              lpszSearchString,
  [out] LPGOPHER_FIND_DATAA 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 un cadena terminada en nullque contiene el nombre del elemento que se va a buscar. Puede ser uno de los siguientes:

Localizador gopher devuelto por una llamada anterior a esta función o la función InternetFindNextFile.
puntero NULL o cadena vacía que indica que se devuelve la información más superior 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 para un servidor de índices. De lo contrario, este parámetro debe ser NULL.

[out] lpFindData

Puntero a una estructura 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 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 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 se ejecuta correctamente o null de lo contrario. Para recuperar información de error extendida, llame a GetLastError o InternetGetLastResponseInfo.

Observaciones

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 de una enumeración, una aplicación puede usar la función InternetFindNextFile para recuperar 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 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 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

Compartir a través de