Freigeben über


CFtpConnection::PutFile

Rufen Sie die Memberfunktion auf, um eine Datei auf einem FTP-Server zu speichern.

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

Parameter

  • pstrLocalFile
    Ein Zeiger auf eine Zeichenfolge, die den Namen der Datei enthält, die vom lokalen System zu senden.

  • pstrRemoteFile
    Ein Zeiger auf eine Zeichenfolge, die den Namen der Datei enthält, die auf dem FTP-Server zu erstellen.

  • dwFlags
    Gibt die Bedingungen, unter denen die Übertragung der Datei auftritt. Kann eine der FTP_TRANSFER_*-Konstanten, die in OpenFile beschrieben werden.

  • dwContext
    Der Kontextbezeichner für das Platzieren der Datei. Siehe Remarks weitere Informationen zu dwContext.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls. Wenn der Aufruf fehlschlägt, wird die GetLastError Win32-Funktion aufgerufen werden, um die Fehlerursache zu bestimmen.

Hinweise

PutFile ist eine Routine auf hoher Ebene, die alle Operationen behandelt, die mit dem Speichern einer Datei auf einem FTP-Server zugeordnet werden. Anwendungen, die nur Daten senden oder die genaueres Kontrolle über die Dateiübertragung benötigen, sollten OpenFile und CInternetFile::Write verwenden.

Überschreiben Sie den dwContext Standard, um den Kontextbezeichner zu einem Wert der Auswahl festzulegen. Der Kontextbezeichner wird mit diesem Einzelgeschäft CFtpConnection des Objekts zugeordnet, das durch sein CInternetSession-Objekt erstellt wird. Der Wert wird auf CInternetSession::OnStatusCallback zurückgegeben, um den Status von dem Vorgang bereitzustellen, mit dem die identifiziert wird. Weitere Informationen finden Sie im Artikel Internet-erste Schritte: WinInet-Klassen weitere Informationen über den Kontextbezeichner.

Anforderungen

Header: afxinet.h

Siehe auch

Referenz

CFtpConnection-Klasse

Hierarchiediagramm

CInternetConnection-Klasse