FtpPutFileW-Funktion (wininet.h)
Speichert eine Datei auf dem FTP-Server.
Syntax
BOOL FtpPutFileW(
[in] HINTERNET hConnect,
[in] LPCWSTR lpszLocalFile,
[in] LPCWSTR lpszNewRemoteFile,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
Parameter
[in] hConnect
Behandeln sie eine FTP-Sitzung.
[in] lpszLocalFile
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen der Datei enthält, die vom lokalen System gesendet werden soll.
[in] lpszNewRemoteFile
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen der Datei enthält, die auf dem Remotesystem erstellt werden soll.
[in] dwFlags
Bedingungen, unter denen die Übertragungen erfolgen. Die Anwendung sollte einen Übertragungstyp und eines der Flags auswählen, die steuern, wie die Zwischenspeicherung der Datei gesteuert wird.
Der Übertragungstyp kann ein beliebiger der folgenden Werte sein.
Die folgenden Werte werden verwendet, um das Zwischenspeichern der Datei zu steuern. Die Anwendung kann einen oder mehrere der folgenden Werte verwenden.
[in] dwContext
Zeigen Sie auf eine Variable, die den anwendungsdefinierten Wert enthält, der diese Suche allen Anwendungsdaten zuordnet. Dieser Parameter wird nur verwendet, wenn die Anwendung bereits InternetSetStatusCallback- aufgerufen hat, um einen Statusrückruf einzurichten.
Rückgabewert
Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls. Rufen Sie GetLastError-auf, um eine bestimmte Fehlermeldung zu erhalten.
Bemerkungen
FtpPutFile- ist eine allgemeine Routine, die alle Buchführungs- und Overhead-Vorgänge verarbeitet, die mit dem lokalen Lesen einer Datei und dem Speichern einer Datei auf einem FTP-Server verbunden sind. Eine Anwendung, die nur Dateidaten senden muss oder die eine enge Kontrolle über die Dateiübertragung erfordert, sollte die funktionen FtpOpenFile und InternetWriteFile- verwenden.
Wenn der dwFlags Parameter FILE_TRANSFER_TYPE_ASCIIangibt, konvertiert die Übersetzung der Dateidaten Steuer- und Formatierungszeichen in lokale Entsprechungen.
Sowohl lpszNewRemoteFile als auch lpszLocalFile- können teilweise oder vollqualifizierte Dateinamen relativ zum aktuellen Verzeichnis sein.
Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte sicher aufgerufen werden.
Anmerkung
Der wininet.h-Header definiert FtpPutFile als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform- | Fenster |
Header- | wininet.h |
Library | Wininet.lib |
DLL- | Wininet.dll |