CFtpConnection::PutFile

Chiamare la funzione membro per archiviare un file su un server FTP.

BOOL PutFile(
   LPCTSTR pstrLocalFile,
   LPCTSTR pstrRemoteFile,
   DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
   DWORD_PTR dwContext = 1 
);

Parametri

  • pstrLocalFile
    Un puntatore a una stringa contenente il nome del file per inviare dal sistema locale.

  • pstrRemoteFile
    Un puntatore a una stringa contenente il nome del file per creare il server FTP.

  • dwFlags
    Specifica le condizioni in cui il trasferimento di file si verifica.Possono essere una qualsiasi delle costanti di FTP_TRANSFER_* descritte in OpenFile.

  • dwContext
    L'identificatore di contesto per salvare il 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

PutFile è una routine di livello elevato che esegue tutte le operazioni associate a archiviare un file su un server FTP.Le applicazioni che inviano solo i dati, o che richiedono il controllo più accurato sul trasferimento di file, devono utilizzare OpenFile e CInternetFile::Write.

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

Vedere anche

Riferimenti

Classe di CFtpConnection

Grafico della gerarchia

Classe di CInternetConnection