CFtpConnection::GetFile

BOOL GetFile (LPCTSTR PstrRemoteFile, LPCTSTR PstrLocalFile, BOOL bFailIfExists = TRUE, DWORD DwAttributes = FILE_ATTRIBUTE_NORMAL, DWORD DwFlags = FTP_TRANSFER_TYPE_BINARY, DWORD DwContext = 1);

Rückgabewert

Ungleich NULL, wenn erfolgreich; andernfalls 0. Wenn der Aufruf fehlschlägt, die Win32-Funktion GetLastError kann aufgerufen werden, um die Ursache des Fehlers zu ermitteln.

Parameter

pstrRemoteFile

Ein Zeiger auf eine auf Null endende Zeichenfolge mit dem Namen einer Datei vom FTP-Server abrufen.

pstrLocalFile

Ein Zeiger auf eine auf Null endende Zeichenfolge mit dem Namen der Datei auf dem lokalen System erstellen.

bFailIfExists

Gibt an, ob der Dateiname bereits von einer vorhandenen Datei verwendet werden kann. Wenn der lokale Dateiname bereits vorhanden ist, und dieser Parameter TRUEist, schlägt GetFile . Andernfalls wird GetFile die vorhandene Kopie der Datei löschen.

dwAttributes

Gibt die Attribute der Datei. Dies kann eine beliebige Kombination der folgenden Flags FILE_ATTRIBUTE_ * sein.

dwFlags

Gibt die Bedingungen, unter denen die Übertragung erfolgt. Dieser Parameter kann die DwFlags -Werte beschrieben, die FtpGetFile im Plattform-SDK.

dwContext

Den Kontextbezeichner für das Abrufen von Dateien. Weitere Informationen über DwContext finden Sie Hinweise.

Bemerkungen

Rufen Sie diese Memberfunktion um erhalten eine Datei von einem FTP-Server und auf dem lokalen Computer speichern.

GetFile ist eine High-Level Routine, die alle das Lesen einer Datei von einem ftpserver und speichern es lokal zugeordneten Overhead behandelt. Anwendungen, die nur Daten abrufen, oder das enge Kontrolle über die Dateiübertragung erforderlich, sollte stattdessen OpenFile und CInternetFile::Read.

Wenn DwFlags FILE_TRANSFER_TYPE_ASCII ist, konvertiert Übersetzung von Dateidaten auch Steuerelement und Formatieren von Zeichen in Windows-Entsprechungen. Der Standard-Transfer ist Binär-Modus, wo ist die Datei in demselben Format heruntergeladen, wie es auf dem Server gespeichert ist.

PstrRemoteFile und PstrLocalFile können entweder 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. GetFile übersetzt die Verzeichnis Name Separatoren mit den entsprechenden Zeichen, bevor sie verwendet werden.

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

Index