Teilen über

CFtpConnection-Klasse

  • Artikel

Verwaltet Ihre FTP-Verbindung mit einem Internetserver und ermöglicht die direkte Manipulation von Verzeichnissen und Dateien auf diesem Server.

Syntax

class CFtpConnection : public CInternetConnection

Member

Öffentliche Konstruktoren

Name Beschreibung
CFtpConnection::CFtpConnection Erstellt ein CFtpConnection-Objekt.

Öffentliche Methoden

Name Beschreibung
CFtpConnection::Command Sendet einen Befehl direkt an einen FTP-Server.
CFtpConnection::CreateDirectory Erstellt ein Verzeichnis auf dem Server.
CFtpConnection::GetCurrentDirectory Ruft das aktuelle Verzeichnis für diese Verbindung ab.
CFtpConnection::GetCurrentDirectoryAsURL Ruft das aktuelle Verzeichnis für diese Verbindung als URL ab.
CFtpConnection::GetFile Ruft eine Datei vom verbundenen Server ab.
CFtpConnection::OpenFile Öffnet eine Datei auf dem verbundenen Server.
CFtpConnection::P utFile Platziert eine Datei auf dem Server.
CFtpConnection::Remove Entfernt eine Datei vom Server.
CFtpConnection::RemoveDirectory Entfernt das angegebene Verzeichnis vom Server.
CFtpConnection::Rename Benennt eine Datei auf dem Server um.
CFtpConnection::SetCurrentDirectory Legt das aktuelle FTP-Verzeichnis fest.

Hinweise

FTP ist einer der drei Internetdienste, die von den MFC WinInet-Klassen erkannt werden.

Um mit einem FTP-Internetserver zu kommunizieren, müssen Sie zuerst eine Instanz von CInternetSession erstellen und dann ein CFtpConnection Objekt erstellen. Sie erstellen ein CFtpConnection Objekt nie direkt. Rufen Sie stattdessen CInternetSession::GetFtpConnection auf, das das CFtpConnection Objekt erstellt und einen Zeiger darauf zurückgibt.

Weitere Informationen zur CFtpConnection Funktionsweise mit den anderen MFC-Internetklassen finden Sie im Artikel "Internet Programming with WinInet". Weitere Informationen zur Kommunikation mit den anderen beiden unterstützten Diensten, HTTP und Gopher, finden Sie unter den Klassen CHttpConnection und CGopherConnection.

Beispiel

Sehen Sie sich das Beispiel in der Übersicht über die CFtpFileFind-Klasse an.

Vererbungshierarchie

CObject

CInternetConnection

CFtpConnection

Anforderungen

Kopfzeile: afxinet.h

CFtpConnection::CFtpConnection

Diese Memberfunktion wird aufgerufen, um ein CFtpConnection Objekt zu erstellen.

CFtpConnection(
    CInternetSession* pSession,
    HINTERNET hConnected,
    LPCTSTR pstrServer,
    DWORD_PTR dwContext);

CFtpConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL,
    DWORD_PTR dwContext = 0,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    BOOL bPassive = FALSE);

Parameter

pSession
Ein Zeiger auf das zugehörige CInternetSession-Objekt .

hConnected
Das Windows-Handle der aktuellen Internetsitzung.

pstrServer
Ein Zeiger auf eine Zeichenfolge, die den FTP-Servernamen enthält.

dwContext
Der Kontextbezeichner für den -Vorgang. dwContext identifiziert die Statusinformationen des Vorgangs, die von CInternetSession::OnStatusCallback zurückgegeben werden. Der Standardwert ist auf 1 festgelegt; Sie können jedoch explizit eine bestimmte Kontext-ID für den Vorgang zuweisen. Das Objekt und alle Arbeiten, die es ausführt, werden mit dieser Kontext-ID verknüpft.

pstrUserName
Zeiger auf eine nullterminierte Zeichenkette, die den Namen der Benutzerin bzw. des Benutzers angibt, die bzw. der sich anmelden soll. Wenn NULL, ist der Standardwert anonym.

pstrPassword
Ein Zeiger auf eine nullterminierte Zeichenkette, die das Kennwort für die Anmeldung angibt. Wenn sowohl pstrPassword als auch pstrUserName NULL sind, ist das standardmäßige anonyme Kennwort der E-Mail-Name des Benutzers. Wenn pstrPassword NULL (oder eine leere Zeichenfolge) ist, aber pstrUserName nicht NULL ist, wird ein leeres Kennwort verwendet. In der folgenden Tabelle wird das Verhalten für die vier möglichen Einstellungen von pstrUserName und pstrPassword beschrieben:

pstrUserName pstrPassword An FTP-Server gesendeter Benutzername An FTP-Server gesendetes Kennwort
NULL oder " " NULL oder " " "anonym" E-Mail-Name der Benutzerin bzw. des Benutzers
Zeichenfolge ungleich NULL NULL oder " " pstrUserName " "
NULL-Zeichenfolge ungleich NULL FEHLER FEHLER
Zeichenfolge ungleich NULL Zeichenfolge ungleich NULL pstrUserName pstrPassword

nPort
Eine Zahl, die den auf dem Server zu verwendenden TCP/IP-Port angibt.

bPassive
Gibt den passiven oder aktiven Modus für diese FTP-Sitzung an. Wenn dieser Wert auf TRUE festgelegt ist, wird der Win32-API dwFlag auf INTERNET_FLAG_PASSIVE festgelegt.

Hinweise

Sie erstellen nie direkt ein CFtpConnection Objekt. Rufen Sie stattdessen CInternetSession::GetFtpConnection auf, wodurch das CFptConnection Objekt erstellt wird.

CFtpConnection::Command

Sendet einen Befehl direkt an einen FTP-Server.

CInternetFile* Command(
    LPCTSTR pszCommand,
    CmdResponseType eResponse = CmdRespNone,
    DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
    DWORD_PTR dwContext = 1);

Parameter

pszCommand
Ein Zeiger auf eine Zeichenfolge, die den zu sendenden Befehl enthält.

eResponse
Gibt an, ob eine Antwort vom FTP-Server erwartet wird. Folgenden Werte sind möglich:

  • CmdRespNone Es wird keine Antwort erwartet.
  • CmdRespRead Es wird eine Antwort erwartet.
  • CmdRespWrite Wird nicht verwendet.

CmdResponseType ist ein Mitglied von CFtpConnection, das in afxinet.h definiert ist.

dwFlags
Ein Wert mit den Flags, die diese Funktion steuern. Eine vollständige Liste finden Sie unter FTPCommand.

dwContext
Ein Zeiger auf einen Wert mit einem anwendungsdefinierten Wert, der zur Identifizierung des Anwendungskontexts in Rückrufen verwendet wird.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Diese Memberfunktion emuliert die Funktionalität der FTPCommand-Funktion , wie im Windows SDK beschrieben.

Wenn ein Fehler auftritt, löst MFC eine Ausnahme vom Typ CInternetException aus.

CFtpConnection::CreateDirectory

Rufen Sie diese Memberfunktion auf, um ein Verzeichnis auf dem verbundenen Server zu erstellen.

BOOL CreateDirectory(LPCTSTR pstrDirName);

Parameter

pstrDirName
Ein Zeiger auf eine Zeichenfolge, die den Namen des zu erstellenden Verzeichnisses enthält.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null). Wenn der Aufruf fehlschlägt, kann die Windows-Funktion GetLastError aufgerufen werden, um die Ursache des Fehlers zu ermitteln.

Hinweise

Wird verwendet GetCurrentDirectory , um das aktuelle Arbeitsverzeichnis für diese Verbindung mit dem Server zu ermitteln. Gehen Sie nicht davon aus, dass das Remotesystem Sie mit dem Stammverzeichnis verbunden hat.

Der pstrDirName Parameter kann entweder ein teilweiser oder ein vollqualifizierter Dateiname relativ zum aktuellen Verzeichnis sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. CreateDirectory übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

CFtpConnection::GetCurrentDirectory

Rufen Sie diese Memberfunktion auf, um den Namen des aktuellen Verzeichnisses abzurufen.

BOOL GetCurrentDirectory(CString& strDirName) const;

BOOL GetCurrentDirectory(
    LPTSTR pstrDirName,
    LPDWORD lpdwLen) const;

Parameter

strDirName
Ein Verweis auf eine Zeichenfolge, die den Namen des Verzeichnisses empfängt.

pstrDirName
Ein Zeiger auf eine Zeichenfolge, die den Namen des Verzeichnisses empfängt.

lpdwLen
Ein Zeiger auf ein DWORD, das die folgenden Informationen enthält:

On entry: The size of the buffer referenced by pstrDirName.

Bei Rückgabe: Die Anzahl der in pstrDirName gespeicherten Zeichen. Wenn die Memberfunktion fehlschlägt und ERROR_INSUFFICIENT_BUFFER zurückgegeben wird, enthält lpdwLen die Anzahl der Bytes, die die Anwendung zuweisen muss, um die Zeichenfolge zu empfangen.

Rückgabewert

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

Hinweise

Rufen Sie GetCurrentDirectoryAsURL auf, um den Verzeichnisnamen stattdessen als URL abzurufen.

Die Parameter pstrDirName oder strDirName können teilweise qualifizierte Dateinamen relativ zum aktuellen Verzeichnis oder vollqualifizierten Sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. GetCurrentDirectory übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

CFtpConnection::GetCurrentDirectoryAsURL

Rufen Sie diese Memberfunktion auf, um den Namen des aktuellen Verzeichnisses als URL abzurufen.

BOOL GetCurrentDirectoryAsURL(CString& strDirName) const;

BOOL GetCurrentDirectoryAsURL(
    LPTSTR pstrName,
    LPDWORD lpdwLen) const;

Parameter

strDirName
Ein Verweis auf eine Zeichenfolge, die den Namen des Verzeichnisses empfängt.

pstrDirName
Ein Zeiger auf eine Zeichenfolge, die den Namen des Verzeichnisses empfängt.

lpdwLen
Ein Zeiger auf ein DWORD, das die folgenden Informationen enthält:

On entry: The size of the buffer referenced by pstrDirName.

Bei Rückgabe: Die Anzahl der in pstrDirName gespeicherten Zeichen. Wenn die Memberfunktion fehlschlägt und ERROR_INSUFFICIENT_BUFFER zurückgegeben wird, enthält lpdwLen die Anzahl der Bytes, die die Anwendung zuweisen muss, um die Zeichenfolge zu empfangen.

Rückgabewert

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

Hinweise

GetCurrentDirectoryAsURL verhält sich genauso wie "GetCurrentDirectory".

Der Parameter strDirName kann entweder teilweise qualifizierte Dateinamen relativ zum aktuellen Verzeichnis oder vollqualifizierten sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. GetCurrentDirectoryAsURL übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

CFtpConnection::GetFile

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

BOOL GetFile(
    LPCTSTR pstrRemoteFile,
    LPCTSTR pstrLocalFile,
    BOOL bFailIfExists = TRUE,
    DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL,
    DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
    DWORD_PTR dwContext = 1);

Parameter

pstrRemoteFile
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen einer Datei enthält, die vom FTP-Server abgerufen werden soll.

pstrLocalFile
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen der Datei enthält, die im lokalen System erstellt werden soll.

bFailIfExists
Gibt an, ob der Dateiname möglicherweise bereits von einer vorhandenen Datei verwendet wird. Wenn der lokale Dateiname bereits vorhanden ist und dieser Parameter WAHR ist, GetFile schlägt ein Fehler fehl. GetFile Andernfalls wird die vorhandene Kopie der Datei gelöscht.

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

  • FILE_ATTRIBUTE_ARCHIVE Die Datei ist eine Archivdatei. Anwendungen verwenden dieses Attribut, um Dateien für die Sicherung oder Entfernung zu markieren.

  • FILE_ATTRIBUTE_COMPRESSED Die Datei oder das Verzeichnis wird komprimiert. Bei einer Datei bedeutet die Komprimierung, dass alle Daten in der Datei komprimiert werden. Für ein Verzeichnis ist die Komprimierung die Standardeinstellung für neu erstellte Dateien und Unterverzeichnisse.

  • FILE_ATTRIBUTE_DIRECTORY Die Datei ist ein Verzeichnis.

  • FILE_ATTRIBUTE_NORMAL Die Datei hat keine anderen Attribute festgelegt. Dieses Attribut ist nur gültig, wenn es allein verwendet wird. Alle anderen Dateiattribute überschreiben FILE_ATTRIBUTE_NORMAL:

  • FILE_ATTRIBUTE_HIDDEN Die Datei ist ausgeblendet. Sie darf nicht in eine normale Verzeichnisauflistung aufgenommen werden.

  • FILE_ATTRIBUTE_READONLY Die Datei ist schreibgeschützt. Anwendungen können die Datei lesen, aber nicht in sie schreiben oder löschen.

  • FILE_ATTRIBUTE_SYSTEM Die Datei ist Teil oder wird ausschließlich vom Betriebssystem verwendet.

  • FILE_ATTRIBUTE_TEMPORARY Die Datei wird für temporären Speicher verwendet. Anwendungen sollten nur bei Bedarf in die Datei schreiben. Die meisten Daten der Datei verbleiben im Arbeitsspeicher, ohne auf die Medien geleert zu werden, da die Datei bald gelöscht wird.

dwFlags
Gibt die Bedingungen an, unter denen die Übertragung erfolgt. Dieser Parameter kann eine der dwFlags-Werte sein, die in FtpGetFile im Windows SDK beschrieben werden.

dwContext
Der Kontextbezeichner für den Dateiabruf. Weitere Informationen zu dwContext finden Sie in den Hinweisen.

Rückgabewert

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

Hinweise

GetFile ist eine allgemeine Routine, die den gesamten Aufwand behandelt, der mit dem Lesen einer Datei von einem FTP-Server verbunden ist und lokal speichert. Anwendungen, die nur Dateidaten abrufen oder die eine enge Kontrolle über die Dateiübertragung erfordern, sollten stattdessen CInternetFile::Read verwenden OpenFile .

Wenn dwFlags FILE_TRANSFER_TYPE_ASCII ist, konvertiert die Übersetzung von Dateidaten auch Steuer- und Formatierungszeichen in Windows-Entsprechungen. Die Standardübertragung ist der Binärmodus, in dem die Datei im gleichen Format heruntergeladen wird wie auf dem Server.

Sowohl pstrRemoteFile als auch pstrLocalFile können teilweise qualifizierte Dateinamen relativ zum aktuellen Verzeichnis oder vollqualifizierte sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. GetFile übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

Überschreiben Sie den dwContext-Standardwert , um den Kontextbezeichner auf einen Wert Ihrer Wahl festzulegen. Der Kontextbezeichner ist diesem spezifischen Vorgang des Objekts zugeordnet, das von seinem CFtpConnection CInternetSession-Objekt erstellt wurde. Der Wert wird an CInternetSession::OnStatusCallback zurückgegeben, um den Status für den Vorgang bereitzustellen, mit dem er identifiziert wird. Weitere Informationen zum Kontextbezeichner finden Sie im Artikel "Internet First Steps: WinInet ".

CFtpConnection::OpenFile

Rufen Sie diese 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. Kann entweder GENERIC_READ oder GENERIC_WRITE sein, aber nicht beide.

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

  • FTP_TRANSFER_TYPE_ASCII Die Dateiübertragungen mithilfe der FTP ASCII-Übertragungsmethode (Type A). Konvertiert Steuerelement- und Formatierungsinformationen in lokale Entsprechungen.

  • FTP_TRANSFER_TYPE_BINARY Die Datei überträgt Daten mithilfe der FTP Image (Type I)-Übertragungsmethode. Die Datei überträgt Daten genau so, wie sie vorhanden ist, ohne Änderungen. Dies ist die Standardübertragungsmethode.

dwContext
Der Kontextbezeichner zum Öffnen der Datei. Weitere Informationen zu dwContext finden Sie in den Hinweisen.

Rückgabewert

Ein Zeiger auf ein CInternetFile-Objekt .

Hinweise

OpenFile sollte in den folgenden Situationen verwendet werden:

  • Eine Anwendung verfügt über Daten, die als Datei auf dem FTP-Server gesendet und erstellt werden müssen, diese Daten befinden sich jedoch nicht in einer lokalen Datei. Sobald OpenFile eine Datei geöffnet wird, verwendet die Anwendung CInternetFile::Write , um die FTP-Dateidaten an den Server zu senden.

  • Eine Anwendung muss eine Datei vom Server abrufen und in den anwendungsgesteuerten Speicher platzieren, anstatt sie auf den Datenträger zu schreiben. Die Anwendung verwendet CInternetFile::Read , nachdem OpenFile sie zum Öffnen der Datei verwendet wurde.

  • Eine Anwendung benötigt eine feine Kontrolle über eine Dateiübertragung. Beispielsweise kann die Anwendung ein Statussteuerelement anzeigen, das den Fortschritt des Dateiübertragungsstatus anzeigt, während eine Datei heruntergeladen wird.

Nach dem Aufrufen OpenFile und bis zum Aufrufen CInternetFile::Closekann die Anwendung nur CInternetFile::Read, CInternetFile::Write, CInternetConnection::Closeoder CFtpFileFind::FindFile aufrufen. Aufrufe an andere FTP-Funktionen für dieselbe FTP-Sitzung schlagen fehl und legen den Fehlercode auf FTP_ETRANSFER_IN_PROGRESS fest.

Der PstrFileName-Parameter kann entweder ein teilweise qualifizierter Dateiname relativ zum aktuellen Verzeichnis oder vollqualifizierten Sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. OpenFile übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

Überschreiben Sie den dwContext-Standardwert , um den Kontextbezeichner auf einen Wert Ihrer Wahl festzulegen. Der Kontextbezeichner ist diesem spezifischen Vorgang des Objekts zugeordnet, das von seinem CFtpConnection CInternetSession-Objekt erstellt wurde. Der Wert wird an CInternetSession::OnStatusCallback zurückgegeben, um den Status für den Vorgang bereitzustellen, mit dem er identifiziert wird. Weitere Informationen zum Kontextbezeichner finden Sie im Artikel "Internet First Steps: WinInet ".

CFtpConnection::P utFile

Rufen Sie diese Memberfunktion auf, um eine Datei auf einem FTP-Server zu speichern.

BOOL PutFile(
    LPCTSTR pstrLocalFile,
    LPCTSTR pstrRemoteFile,
    DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
    DWORD_PTR dwContext = 1);

Parameter

pstrLocalFile
Ein Zeiger auf eine Zeichenfolge, die den Namen der Datei enthält, die vom lokalen System gesendet werden soll.

pstrRemoteFile
Ein Zeiger auf eine Zeichenfolge, die den Namen der Datei enthält, die auf dem FTP-Server erstellt werden soll.

dwFlags
Gibt die Bedingungen an, unter denen die Übertragung der Datei erfolgt. Dies kann eine der in OpenFile beschriebenen FTP_TRANSFER_*-Konstanten sein.

dwContext
Der Kontextbezeichner zum Platzieren der Datei. Weitere Informationen zu dwContext finden Sie in den Hinweisen.

Rückgabewert

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

Hinweise

PutFile ist eine allgemeine Routine, die alle Vorgänge verarbeitet, die zum Speichern einer Datei auf einem FTP-Server zugeordnet sind. Anwendungen, die nur Daten senden oder eine engere Kontrolle über die Dateiübertragung erfordern, sollten OpenFile und CInternetFile::Write verwenden.

Überschreiben Sie den dwContext-Standard, um den Kontextbezeichner auf einen ausgewählten Wert festzulegen. Der Kontextbezeichner ist diesem spezifischen Vorgang des Objekts zugeordnet, das von seinem CFtpConnection CInternetSession-Objekt erstellt wurde. Der Wert wird an CInternetSession::OnStatusCallback zurückgegeben, um den Status für den Vorgang bereitzustellen, mit dem er identifiziert wird. Weitere Informationen zum Kontextbezeichner finden Sie im Artikel "Internet First Steps: WinInet ".

CFtpConnection::Remove

Rufen Sie diese Memberfunktion auf, um die angegebene Datei vom verbundenen Server zu löschen.

BOOL Remove(LPCTSTR pstrFileName);

Parameter

pstrFileName
Ein Zeiger auf eine Zeichenfolge, die den zu entfernenden Dateinamen enthält.

Rückgabewert

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

Hinweise

Der PstrFileName-Parameter kann entweder ein teilweise qualifizierter Dateiname relativ zum aktuellen Verzeichnis oder vollqualifizierten Sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. Die Remove Funktion übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

CFtpConnection::RemoveDirectory

Rufen Sie diese Memberfunktion auf, um das angegebene Verzeichnis vom verbundenen Server zu entfernen.

BOOL RemoveDirectory(LPCTSTR pstrDirName);

Parameter

pstrDirName
Ein Zeiger auf eine Zeichenfolge, die das zu entfernende Verzeichnis enthält.

Rückgabewert

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

Hinweise

Verwenden Sie GetCurrentDirectory , um das aktuelle Arbeitsverzeichnis des Servers zu ermitteln. Gehen Sie nicht davon aus, dass das Remotesystem Sie mit dem Stammverzeichnis verbunden hat.

Der PstrDirName-Parameter kann entweder ein teilweiser oder vollqualifizierter Dateiname relativ zum aktuellen Verzeichnis sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. RemoveDirectory übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

CFtpConnection::Rename

Rufen Sie diese Memberfunktion auf, um die angegebene Datei auf dem verbundenen Server umzubenennen.

BOOL Rename(
    LPCTSTR pstrExisting,
    LPCTSTR pstrNew);

Parameter

pstrExisting
Ein Zeiger auf eine Zeichenfolge, die den aktuellen Namen der datei enthält, die umbenannt werden soll.

pstrNew
Ein Zeiger auf eine Zeichenfolge, die den neuen Namen der Datei enthält.

Rückgabewert

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

Hinweise

Die Parameter "pstrExisting " und "pstrNew " können entweder einen teilweise qualifizierten Dateinamen relativ zum aktuellen Verzeichnis oder vollqualifizierten Dateinamen sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. Rename übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

CFtpConnection::SetCurrentDirectory

Rufen Sie diese Memberfunktion auf, um zu einem anderen Verzeichnis auf dem FTP-Server zu wechseln.

BOOL SetCurrentDirectory(LPCTSTR pstrDirName);

Parameter

pstrDirName
Ein Zeiger auf eine Zeichenfolge, die den Namen des Verzeichnisses enthält.

Rückgabewert

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

Hinweise

Der PstrDirName-Parameter kann entweder ein teilweiser oder vollqualifizierter Dateiname relativ zum aktuellen Verzeichnis sein. Ein umgekehrter Schrägstrich (\) oder Schrägstrich (/) kann als Verzeichnistrennzeichen für einen der beiden Namen verwendet werden. SetCurrentDirectory übersetzt die Verzeichnisnamentrennzeichen in die entsprechenden Zeichen, bevor sie verwendet werden.

Verwenden Sie GetCurrentDirectory , um das aktuelle Arbeitsverzeichnis eines FTP-Servers zu ermitteln. Gehen Sie nicht davon aus, dass das Remotesystem Sie mit dem Stammverzeichnis verbunden hat.

Siehe auch

CInternetConnection-Klasse
Hierarchiediagramm
CInternetConnection-Klasse
CInternetSession-Klasse