CFtpConnection::OpenFile

Artículo
02/19/2013

Llame a esta función miembro para abrir un archivo ubicado en un servidor FTP para lectura o escritura.

CInternetFile* OpenFile(
   LPCTSTR pstrFileName,
   DWORD dwAccess = GENERIC_READ,
   DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
   DWORD_PTR dwContext = 1 
);

Parámetros

pstrFileName
Un puntero a una cadena que contiene el nombre del archivo que se va a abrir.
dwAccess
Determina cómo el archivo tendrá acceso.pueden ser GENERIC_READ o GENERIC_WRITE, pero no ambos.
dwFlags
Especifica las condiciones en las que las transferencias subsiguientes aparecen.Esto puede ser cualquiera de las constantes de FTP_TRANSFER_*:
- Las transferencias de archivos de FTP_TRANSFER_TYPE_ASCII The mediante FTP ASCII (método de transferencia de tipo A).Convierte la información del control y el formato a equivalentes locales.
- Datos de transferencias de archivos de FTP_TRANSFER_TYPE_BINARY The mediante el método transfer Image de FTP (tipo I).Los datos de las transferencias de archivos tal como existe, sin cambios.Este es el método predeterminado de transferencia.
dwContext
El identificador de contexto para abrir el archivo.Vea Comentarios para obtener más información sobre dwContext.

Valor devuelto

un puntero a un objeto de CInternetFile .

Comentarios

OpenFile se debe utilizar en las situaciones siguientes:

Una aplicación tiene datos que necesite ser enviados y crear como un archivo en el servidor FTP, pero que no está los datos en un archivo local.Una vez que abra OpenFile un archivo, la aplicación utiliza CInternetFile:: Escribir para enviar los datos de archivo de FTP al servidor.
Una aplicación debe recuperar un archivo de servidor y colocarlo en la memoria aplicación-controlada, en lugar de escribirla en el disco.La aplicación utiliza CInternetFile:: lectura después de utilizar OpenFile para abrir el archivo.
Una aplicación necesita un nivel de control preciso sobre una transferencia de archivos.Por ejemplo, la aplicación puede mostrar un control de progreso indica el progreso del estado de transferencia de archivos mientras descarga un archivo.

Después de llamar a OpenFile y hasta llamar CInternetConnection::Cerrar, la aplicación puede llamar a CInternetFile:: lectura, CInternetFile:: Escribir, CInternetConnection::Cerrar, o CFtpFileFind:: FindFile.Las llamadas a otras funciones FTP para la misma sesión FTP producirán errores y establecerá el código de error a FTP_ETRANSFER_IN_PROGRESS.

el parámetro de pstrFileName puede ser un nombre de archivo parcialmente calificado en relación con el directorio actual o completo.Una barra diagonal inversa (\) o una barra diagonal (/) se puede utilizar como separador de directorio para cualquier nombre.OpenFile traduce los separadores de nombre de directorio a los caracteres apropiados antes de utilizarla.

Reemplace el valor predeterminado de dwContext para establecer el identificador de contexto a un parámetro de elegir.El identificador de contexto es asociado a esta operación específica del objeto de CFtpConnection creado por el objeto de CInternetSession .El valor se devuelve a CInternetSession:: OnStatusCallback para proporcionar el estado de la operación a la que se identifica.Vea el artículo Primeros pasos de internet: WinInet para obtener más información sobre el identificador del contexto.