CFtpConnection::OpenFile
Rufen Sie die Memberfunktion auf, um eine Datei auf einem FTP-Server zum Lesen oder Schreiben zu öffnen.
CInternetFile* OpenFile(
LPCTSTR pstrFileName,
DWORD dwAccess = GENERIC_READ,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1
);
Parameter
pstrFileName
Ein Zeiger auf eine Zeichenfolge, die den Namen der zu öffnenden Datei enthält.dwAccess
Bestimmt, wie auf die Datei zugegriffen wird.Mit kann entweder GENERIC_READ oder GENERIC_WRITE, jedoch nicht beide.dwFlags
Gibt die Bedingungen, unter denen folgende Übertragungen auftreten.Diese kann jedes der folgenden FTP_TRANSFER_*-Konstanten sein:FTP_TRANSFER_TYPE_ASCII die Dateiübertragungen mithilfe FTP-ASCII (Methode des Typs A) Übergangs.Wird steuern und Formatierungsinformationen in den lokalen - Entsprechungen.
FTP_TRANSFER_TYPE_BINARY die Dateiübertragungsdaten mit Bildern FTP (Methode des Typs I) Übergangs.Die Dateiübertragungsdaten genau, wie vorhanden, ohne Änderungen.Dies ist die Standardeinstellung Übergangsmethode.
dwContext
Der Kontextbezeichner zum Öffnen der Datei.Siehe Remarks weitere Informationen zu dwContext.
Rückgabewert
Ein Zeiger auf ein Objekt CInternetFile.
Hinweise
OpenFile sollte in den folgenden Situationen verwendet werden:
Eine Anwendung verfügt über Daten, die als Datei auf dem FTP-Server gesendet werden und erstellt werden muss, während die Daten nicht in einer lokalen Datei sind.Sobald OpenFile eine Datei geöffnet wird, verwendet die Anwendung CInternetFile::Write, um die FTP-Dateidaten den Server zu senden.
Eine Anwendung muss eine Datei vom Server abrufen und sie in Anwendung-gesteuerten Arbeitsspeicher platzieren, anstatt ihn auf den Datenträger zu schreiben.Nach Verwendung von OpenFile die Anwendung verwendet CInternetFile::Read, um die Datei zu öffnen.
Eine Anwendung ist ein dem Kontrolle über einer Dateiübertragung.Beispielsweise sollte die Anwendung ein Statussteuerelement anzeigen angeben den Status des Dateiübertragungsstatus beim Herunterladen einer Datei.
Nach dem OpenFile und auf das Aufrufen von CInternetConnection::Close ist, kann die Anwendung CInternetFile::Read, CInternetFile::Write, CInternetConnection::Close oder CFtpFileFind::FindFile nur aufrufen aufgerufen hat.Aufrufe von anderen FTP-Funktionen für dieselbe FTP-Sitzung lassen und legen den Fehlercode zu FTP_ETRANSFER_IN_PROGRESS fest.
Der pstrFileName-Parameter kann entweder ein teilweise qualifizierter Dateiname relativ zum aktuellen Verzeichnis oder ein vollqualifiziert sein.Ein umgekehrter Schrägstrich (\) oder einem Schrägstrich (/) können als das Verzeichnistrennzeichen für jeden Namen verwendet werden.vor der Anwendung es OpenFile übersetzt die Verzeichnisnametrennzeichen zu den entsprechenden Zeichen.
Ü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