CFtpConnection::OpenFile

CInternetFile * OpenFile (LPCTSTR PstrFileName, DWORD DwAccess = GENERIC_READ, DWORD DwFlags = FTP_TRANSFER_TYPE_BINARY, DWORD DwContext = 1);

Rückgabewert

Ein Zeiger auf ein Objekt CInternetFile.

Parameter

pstrFileName

Ein Zeiger auf eine Zeichenfolge mit dem Namen der Datei geöffnet werden.

dwAccess

Bestimmt, wie die Datei zugegriffen wird. Kann entweder GENERIC_READ oder GENERIC_WRITE, aber nicht beide.

dwFlags

Gibt die Bedingungen, unter denen nachfolgende Übertragungen stattfinden. Dies kann eine der folgenden Konstanten FTP_TRANSFER_ * sein:

• FTP_TRA&NSFER_TYPE_ASCIInbsp;  Die Dateiübertragungen FTP ASCII (Typ A)-Transfer-Methode verwenden. Konvertiert Kontrolle und Formatierungsinformationen in lokalen Entsprechungen.
  
  
• FTP_TRA&NSFER_TYPE_BINARYnbsp;  Die Datei überträgt Daten mit FTP 's Bildübertragung (Typ I) Methode. Die Datei überträgt Daten genau so, wie es vorhanden ist, ohne Änderungen. Dies ist die Standard-Transfer-Methode.

dwContext

Den Kontextbezeichner für die Datei zu öffnen. Weitere Informationen über DwContext finden Sie Hinweise.

Bemerkungen

Rufen Sie diese Memberfunktion um eine Datei auf einem FTP-Server zum Lesen oder schreiben zu öffnen. OpenFile sollte in den folgenden Situationen verwendet werden:

• Eine Anwendung kann Daten, die gesendet und als Datei auf dem FTP-Server erstellt werden, aber dass keine Daten in einer lokalen Datei. Sobald OpenFile eine Datei öffnet, verwendet die Anwendung CInternetFile::Write um die FTP-Datei-Daten an den Server senden.
  
  
• Eine Anwendung muss eine Datei vom Server abrufen und platzieren es-anwendungsgesteuerte Speicher, anstatt auf die Festplatte schreibt. Die Anwendung verwendet CInternetFile::Read nach OpenFile verwenden, um die Datei zu öffnen.
  
  
• Eine Anwendung benötigt ein feines Maß an Kontrolle über eine Dateiübertragung. Beispielsweise sollten die Anwendung einen Fortschritt anzeigen Steuerelement zeigen den Fortschritt der Übertragung den Status der Datei beim Downloaden einer Datei.

Nach dem Aufrufen der OpenFile und bis Closeaufrufen kann die Anwendung nur CInternetFile::Read, CInternetFile::Write, engeoder CFtpFileFind::FindFileaufrufen. Anrufe zu anderen FTP-Funktionen für die gleichen FTP-Sitzung fehl und legen Sie den Fehlercode auf FTP_ETRANSFER_IN_PROGRESS.

Der PstrFileName -Parameter kann entweder einen teilweise qualifizierten Dateinamen relativ zum aktuellen Verzeichnis oder vollständig qualifiziert. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für entweder Namen verwendet werden. OpenFile übersetzt die Verzeichnis Name Separatoren mit den entsprechenden Zeichen vor der Verwendung.

Außerkraftsetzen der Standardwerte DwContext die Kontext-ID auf den Wert Ihrer Wahl festlegen. Die Kontext-ID ist diese bestimmte Operation des Objekts CFtpConnection erstellt von seinem CInternetSession -Objekt zugeordnet. Der Wert wird zurückgegeben, um CInternetSession::OnStatusCallback zu Status auf den Betrieb mit dem er identifiziert wird. Finden Sie im Artikel Internet erste Schritte: WinInet für weitere Informationen zu den Kontextbezeichner.

CFtpConnection Übersicht |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CInternetConnection, CFtpConnection::GetFile, CGopherConnection::OpenFile, CInternetFile::Write, CInternetFile::Read