CFtpConnection::GetFile
Chiamare la funzione membro per ottenere un file da un server FTP e archiviarlo nel computer locale.
BOOL GetFile(
LPCTSTR pstrRemoteFile,
LPCTSTR pstrLocalFile,
BOOL bFailIfExists = TRUE,
DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1
);
Parametri
pstrRemoteFile
Un puntatore a una stringa con terminazione null contenente il nome di un file per recuperare il server FTP.pstrLocalFile
Un puntatore a una stringa con terminazione null contenente il nome del file per creare nel sistema locale.bFailIfExists
Indica se il nome file può essere già utilizzato da un file esistente. Se il nome file locale esiste già e questo parametro è TRUE, GetFile non riesce. In caso contrario, GetFile cancellerà la copia del file esistente.dwAttributes
Indica gli attributi del file. Ciò può essere qualsiasi combinazione dei seguenti flag di FILE_ATTRIBUTE_*.FILE_ATTRIBUTE_ARCHIVE il file è un file di archivio. Le applicazioni utilizzano questo attributo per contrassegnare i file per l'esecuzione del backup o la rimozione.
FILE_ATTRIBUTE_COMPRESSED il file o la directory è compresso. Per un file, la compressione significa che tutti i dati nel file verranno compressi. Per una directory, la compressione è l'impostazione predefinita per i file e le sottodirectory appena creato.
FILE_ATTRIBUTE_DIRECTORY il file è una directory.
FILE_ATTRIBUTE_NORMAL il file non sono stati impostati altri attributi. Questo attributo è valido solo se utilizzato singolarmente. Tutti gli altri attributi del file eseguono l'override di FILE_ATTRIBUTE_NORMAL:
FILE_ATTRIBUTE_HIDDEN il file è nascosto. Non deve essere incluso in una directory ordinario.
FILE_ATTRIBUTE_READONLY il file è di sola lettura. Le applicazioni possono leggere il file ma non possono scrivere o eliminarlo.
FILE_ATTRIBUTE_SYSTEM il file faccia parte di oppure è utilizzato esclusivamente dal sistema operativo.
FILE_ATTRIBUTE_TEMPORARY il file viene utilizzata per l'archiviazione temporanea. Le applicazioni devono scrivere nel file solo se è assolutamente necessario. La maggior parte dei dati del file rimane in memoria senza essere arrossitoe i contenuti multimediali in quanto il file precedentemente verrà eliminato.
dwFlags
Specifica le condizioni in cui il trasferimento si verifica. Questo parametro può essere uno dei valori dwFlags descritti in FtpGetFile in Windows SDK.dwContext
l'identificatore di contesto per il recupero di file. Vedere Note per ulteriori informazioni su dwContext.
Valore restituito
Diverso da zero se ha esito positivo; in caso contrario 0. Se la chiamata ha esito negativo, la funzione Win32 GetLastError può essere chiamata per determinare la causa dell'errore.
Note
GetFile è una routine di alto livello che gestisce la totalità sovraccarico associato alla lettura del file da un server FTP e memorizzarlo in locale. Le applicazioni che consentono di recuperare solo i dati del file, o che richiedono il controllo accurato sul trasferimento di file, devono utilizzare OpenFile e CInternetFile::Read anziché.
Se dwFlags è FILE_TRANSFER_TYPE_ASCII, una conversione di controllo di dati del file e caratteri di formattazione agli equivalenti di Windows. Il trasferimento predefinito è modalità binaria, in cui il file viene eseguito nello stesso formato quale viene archiviato sul server.
Sia pstrRemoteFile che pstrLocalFile possono essere nomi file relativo alla directory corrente o completata parzialmente qualificati. Una barra rovesciata (\) o una barra (/) può essere utilizzato come separatore di directory per qualsiasi nome. GetFile converte i separatori nome di directory ai caratteri appropriati prima che vengano utilizzati.
Eseguire l'override del valore predefinito dwContext per impostare l'identificatore di contesto a un valore desiderato. L'identificatore di contesto associato a questa operazione specifica dell'oggetto CFtpConnection creato dal relativo oggetto CInternetSession. Il valore viene restituito a CInternetSession::OnStatusCallback per fornire lo stato sull'operazione con cui viene identificato. Vedere l'articolo Primi passaggi Internet: WinInet per ulteriori informazioni sull'identificatore di contesto.
Requisiti
Header: afxinet.h