CFtpConnection::OpenFile

Articolo
03/05/2013

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.