CFtpConnection::OpenFile

Articolo
06/10/2015

Chiamare la funzione membro per aprire un file situato su un server FTP per la lettura o la scrittura.

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

Parametri

pstrFileName
Un puntatore a una stringa contenente il nome del file da aprire.
dwAccess
Determina il modo in cui il file verrà eseguito. È possibile GENERIC_READ o GENERIC_WRITE, ma non entrambi.
dwFlags
Specifica le condizioni in cui i trasferimenti successivi si verificano. Ciò può essere uno dei seguenti costanti di FTP_TRANSFER_*:
- FTP_TRANSFER_TYPE_ASCII i trasferimenti di file utilizzando il metodo ASCII di trasferimento FTP (digitare A). Converte i controlli e informazioni di formattazione agli equivalenti locali.
- FTP_TRANSFER_TYPE_BINARY i dati di trasferimenti di file utilizzando l'immagine FTP (metodo di trasferimento del tipo Di). I dati di trasferimenti di file esattamente come esiste, senza modifiche. È il metodo predefinito di trasferimento.
dwContext
l'identificatore di contesto per aprire il file. Vedere Note per ulteriori informazioni su dwContext.

Valore restituito

Un puntatore a un oggetto CInternetFile.

Note

OpenFile deve essere utilizzato nelle seguenti situazioni:

Un'applicazione dispone di dati che devono essere inviati e creati come file sul server FTP, ma che i dati non sono in un file locale. Una volta che OpenFile apre un file, utilizza CInternetFile::Write di applicazione inviare dati del file del server FTP.
Un'applicazione deve recuperare un file dal server e inserirlo in memoria controllata all'applicazione, anziché scrivere sul disco. L'applicazione utilizza CInternetFile::Read dopo avere utilizzato OpenFile per aprire il file.
Un'applicazione richiede un livello di controllo preciso su un trasferimento di file. Ad esempio, l'applicazione è possibile visualizzare un controllo di stato indica lo stato di avanzamento dello stato di trasferimento di file come scaricare un file.

Dopo aver chiamato OpenFile e finché non viene chiamato CInternetConnection::Close, l'applicazione può chiamare solo CInternetFile::Read, CInternetFile::Write, CInternetConnection::Close, o CFtpFileFind::FindFile. Le chiamate alle funzioni di FTP per la stessa sessione FTP avrà esito negativo e imposteranno il codice di errore a FTP_ETRANSFER_IN_PROGRESS.

Il parametro pstrFileName può essere un nome file parzialmente qualificato relativo alla directory corrente o completo. Una barra rovesciata (\) o una barra (/) può essere utilizzato come separatore di directory per qualsiasi nome. OpenFile converte i separatori nome di directory ai caratteri appropriati prima di utilizzarlo.

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.