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

CFtpConnections-Klasse

Hierarchien-Diagramm

CInternetConnections-Klasse