CFtpConnection::GetFile

BOOL GetFile (LPCTSTR pstrRemoteFile, LPCTSTR pstrLocalFile, BOOL bFailIfExists = TRUE, DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL, DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY, DWORD dwContext = 1);

Valor devuelto

Distinto de cero si es correcto; 0 lo contrario. Si la llamada falla, la función de Win32 GetLastError puede ser llamado para determinar la causa del error.

Parámetros

pstrRemoteFile

Un puntero a una cadena terminada en nulo que contiene el nombre de un archivo para recuperar desde el servidor FTP.

pstrLocalFile

Un puntero a una cadena terminada en nulo que contiene el nombre del archivo que se crea en el sistema local.

bFailIfExists

Indica si el nombre de archivo ya puede utilizarse por un archivo existente. Si ya existe el nombre de archivo local y este parámetro es TRUE, error GetFile . De lo contrario, GetFile borrará la copia del archivo.

dwAttributes

Indica los atributos del archivo. Esto puede ser cualquier combinación de los siguientes indicadores de FILE_ATTRIBUTE_ *.

dwFlags

Especifica las condiciones bajo las cuales se produce la transferencia. Este parámetro puede ser cualquiera de los valores de dwFlags descritos en FtpGetFile en el SDK de la plataforma.

dwContext

El identificador de contexto para la recuperación de archivos. Vea la sección comentarios para obtener más información acerca de dwContext.

Observaciones

Llame a esta función miembro para obtener un archivo desde un servidor FTP y almacenar en el equipo local.

GetFile es una rutina de alto nivel que controla toda la sobrecarga asociada con la lectura de un archivo desde un servidor FTP y almacenar localmente. Aplicaciones que sólo recuperar datos del archivo, o que requieren un control estricto sobre la transferencia de archivos, debe utilizar OpenFile y CInternetFile::Read en su lugar.

Si dwFlags es FILE_TRANSFER_TYPE_ASCII, traducción de archivos de datos convierte también control y caracteres de formato a equivalentes de Windows. La transferencia por defecto es modo binario, donde el archivo se descarga en el mismo formato como se almacena en el servidor.

PstrRemoteFile y pstrLocalFile pueden ser bien parcialmente cualificados los nombres de archivo relativa al directorio actual o completo. Puede utilizarse una barra diagonal inversa (\) o una barra diagonal (/) como separador o nombre de directorio. GetFile traduce los separadores de nombre de directorio a los caracteres adecuados antes de que se utilizan.

Reemplazar el valor predeterminado de dwContext para establecer el identificador de contexto en un valor de su elección. El identificador de contexto se asocia con esta operación específica del objeto CFtpConnection creado por su objeto CInternetSession . El valor es devuelto a CInternetSession:: OnStatusCallback que proporcionan información sobre la operación con la cual se identifica. Consulte el artículo Internet primeros pasos: WinInet para obtener más información sobre el identificador de contexto.

Introducción a CFtpConnection |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CInternetConnection

Index