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
Zeiger auf eine NULL-Zeichenfolge, die den Namen der Datei enthält, die vom lokalen System gesendet werden soll.
[in] lpszNewRemoteFile
Zeiger auf eine 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 das Zwischenspeichern der Datei gesteuert wird.
Der Übertragungstyp kann einer der folgenden Werte sein.
Die folgenden Werte werden verwendet, um die Zwischenspeicherung der Datei zu steuern. Die Anwendung kann mindestens einen der folgenden Werte verwenden.
[in] dwContext
Zeiger auf eine Variable, die den von der Anwendung definierten Wert enthält, der diese Suche allen Anwendungsdaten ordnet. Dieser Parameter wird nur verwendet, wenn die Anwendung bereits InternetSetStatusCallback aufgerufen hat, um einen status Rückruf einzurichten.
Rückgabewert
Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Rufen Sie GetLastError auf, um eine bestimmte Fehlermeldung zu erhalten.
Hinweise
FtpPutFile ist eine allgemeine Routine, die die gesamte Buchhaltung und den gesamten Mehraufwand verarbeitet, der mit dem lokalen Lesen einer Datei und dem Speichern auf einem FTP-Server verbunden ist. Eine Anwendung, die nur Dateidaten senden muss oder eine enge Kontrolle über die Dateiübertragung erfordert, sollte die Funktionen FtpOpenFile und InternetWriteFile verwenden.
Wenn der dwFlags-ParameterFILE_TRANSFER_TYPE_ASCII angibt, werden bei der Übersetzung der Dateidaten Steuerelement- und Formatierungszeichen in lokale Entsprechungen konvertiert.
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 sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.
Hinweis
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 nicht codierungsneutralem Code 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | wininet.h |
Bibliothek | Wininet.lib |
DLL | Wininet.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für