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);

Valore restituito

Diverso da zero in caso di successo; 0 altrimenti. Se la chiamata ha esito negativo, la funzione Win32 può essere chiamato GetLastError per determinare la causa dell'errore.

Parametri

pstrRemoteFile

Puntatore a una stringa null-terminated contenente il nome di un file da recuperare dal server FTP.

pstrLocalFile

Puntatore a una stringa null-terminated contenente il nome del file da creare nel sistema locale.

bFailIfExists

Indica se il nome del file già possa essere utilizzato da un file esistente. Se il nome file locale esiste già, e questo parametro è TRUE, GetFile ha esito negativo. In caso contrario, GetFile cancellerà la copia del file esistente.

dwAttributes

Indica gli attributi del file. Questo può essere qualsiasi combinazione dei seguenti flag FILE_ATTRIBUTE_ *.

• FILE_ATTRIBUTE_ARCHIVE   Il file è un file di archivio. Le applicazioni utilizzano questo attributo per contrassegnare i file per il backup o rimozione.
  
  
• FILE_ATTRIBUTE_COMPRESSED   Il file o la directory è compresso. Per un file, compressione significa che tutti i dati nel file è compresso. Per un indice, la compressione è l'impostazione predefinita per sottodirectory e file appena creati.
  
  
• FILE_ATTRIBUTE_DIRECTORY   Il file è una directory.
  
  
• FILE_ATTRIBUTE_&NORMALnbsp;  Il file non ha nessun altri attributi impostati. Questo attributo è valido solo se utilizzato da solo. Tutti gli altri attributi di file eseguire l'override di FILE_ATTRIBUTE_NORMAL:
  
  
• FILE_ATTRIBUTE_HIDDE&Nnbsp;  Il file è nascosto. Non deve essere incluso in un elenco di directory ordinaria.
  
  
• FILE_ATTRIBUTE_READO&NLYnbsp;  Il file è di sola lettura. Le applicazioni possono leggere il file, ma non può scrivere ad esso o eliminarlo.
  
  
• FILE_ATTRIBUTE_SYSTEM   Il file viene utilizzato esclusivamente dal sistema operativo o fa parte di.
  
  
• FILE_ATTRIBUTE_TEMPORARY   Il file viene essere utilizzato per l'archiviazione temporanea. Applicazioni devono scrivere il file solo se assolutamente necessario. La maggior parte dei dati del file rimane nella memoria senza essere lavata ai media perché il file verrà presto eliminato.

dwFlags

Specifica le condizioni in cui avviene il trasferimento. Questo parametro può essere uno dei valori dwFlags descritti in FtpGetFile in Platform SDK.

dwContext

L'identificatore di contesto per il recupero di file. Vedere la sezione Osservazioni per ulteriori informazioni su dwContext.

Osservazioni

Chiamare questa funzione membro per ottenere un file da un server FTP e memorizzato sul computer locale.

GetFile è una routine di alto livello che gestisce tutte l'overhead associato alla lettura di un file da un server FTP e riporlo localmente. Applicazioni che recuperare solo i dati del file, o che richiedono stretto controllo sopra il trasferimento di file, si dovrebbe utilizzare invece OpenFile e CInternetFile::Read.

Se dwFlags è FILE_TRANSFER_TYPE_ASCII, traduzione di file di dati converte anche controllo e caratteri di formattazione a equivalenti di Windows. Il trasferimento di predefinito è modalità binaria, in cui viene scaricato il file nello stesso formato poiché è archiviata sul server.

Sia pstrRemoteFile che pstrLocalFile può essere sia parzialmente qualificati i nomi dei file relativo alla directory corrente o completo. Una barra rovesciata (\) o una barra (/) può essere utilizzato come separatore di directory per ogni nome. GetFile traduce i separatori di nome directory ai caratteri appropriati prima che vengano utilizzate.

Ignorare il predefinito di dwContext per impostare l'identificatore di contesto a un valore di tua scelta. L'identificatore di contesto è associato a questa operazione specifica dell'oggetto CFtpConnection creato da suo oggetto CInternetSession . Viene restituito il valore di CInternetSession::OnStatusCallback per fornire lo stato sull'operazione con cui viene identificato. Vedere l'articolo Internet primi passi: WinInet per ulteriori informazioni sull'identificatore di contesto.

Panoramica CFtpConnection |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CInternetConnection consente