Función FtpFindFirstFileW (wininet.h)
Busca en el directorio especificado de la sesión FTP especificada. Las entradas de archivo y directorio se devuelven a la aplicación en la estructura WIN32_FIND_DATA.
Sintaxis
HINTERNET FtpFindFirstFileW(
[in] HINTERNET hConnect,
[in] LPCWSTR lpszSearchFile,
[out] LPWIN32_FIND_DATAW lpFindFileData,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
Parámetros
[in] hConnect
Identificador de una sesión FTP devuelta desde InternetConnect.
[in] lpszSearchFile
Puntero a un cadena terminada en nullque especifica una ruta de acceso de directorio o un nombre de archivo válidos para el sistema de archivos del servidor FTP. La cadena puede contener caracteres comodín, pero no se permiten espacios en blanco. Si el valor de lpszSearchFile es NULL o si es una cadena vacía, la función busca el primer archivo en el directorio actual del servidor.
[out] lpFindFileData
Puntero a una estructura de WIN32_FIND_DATA que recibe información sobre el archivo o directorio encontrados.
[in] dwFlags
Controla el comportamiento de esta función. Este parámetro puede ser una combinación de los siguientes valores.
INTERNET_FLAG_HYPERLINK
INTERNET_FLAG_NEED_FILE
INTERNET_FLAG_NO_CACHE_WRITE
INTERNET_FLAG_RELOAD
INTERNET_FLAG_RESYNCHRONIZE
[in] dwContext
Puntero a una variable que especifica el valor definido por la aplicación que asocia esta búsqueda a los datos de la aplicación. Este parámetro solo se usa si la aplicación ya ha llamado a InternetSetStatusCallback para configurar una función de devolución de llamada de estado.
Valor devuelto
Devuelve un identificador válido para la solicitud si la enumeración de directorios se inició correctamente o devuelve NULL de lo contrario. Para obtener un mensaje de error específico, llame a GetLastError. Si GetLastError devuelve ERROR_INTERNET_EXTENDED_ERROR, como en el caso en el que la función no encuentra archivos coincidentes, llame a la función InternetGetLastResponseInfo para recuperar el texto de error extendido, como se documenta en Control de errores.
Observaciones
Para FtpFindFirstFile, los tiempos de archivo devueltos en la estructura WIN32_FIND_DATA están en la zona horaria local, no en un formato de hora universal coordinada (UTC).
Después de llamar a ftpFindFirstFile y hasta que llame a InternetCloseHandle, la aplicación no puede llamar a FtpFindFirstFile de nuevo en el identificador de sesión FTP determinado. Si se realiza una llamada a ftpFindFirstFile en ese identificador, se produce un error en la función con ERROR_FTP_TRANSFER_IN_PROGRESS. Después de que la aplicación de llamada haya terminado de usar el identificador de HINTERNET
Después de iniciar una enumeración de directorios con FtpFindFirstFile, la función InternetFindNextFile se puede usar para continuar con la enumeración.
Dado que el protocolo FTP no proporciona ningún medio estándar de enumeración, parte de la información común sobre archivos, como la fecha y hora de creación de archivos, no siempre está disponible o correcto. Cuando esto sucede, ftpFindFirstFile y InternetFindNextFile rellenar la información no disponible con una mejor estimación basada en la información disponible. Por ejemplo, las fechas de creación y último acceso suelen ser las mismas que la fecha de modificación del archivo.
La aplicación no puede llamar a ftpFindFirstFile entre llamadas a ftpOpenFile y 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 FtpFindFirstFile 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
sesiones FTP de