Share via

CFtpConnection-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Beheert uw FTP-verbinding met een internetserver en maakt directe manipulatie van mappen en bestanden op die server mogelijk.

Syntaxis

class CFtpConnection : public CInternetConnection

Leden

Openbare constructors

Naam Description
CFtpConnection::CFtpConnection Maakt een CFtpConnection object.

Openbare methoden

Naam Description
CFtpConnection::Command Hiermee wordt een opdracht rechtstreeks naar een FTP-server verzonden.
CFtpConnection::CreateDirectory Hiermee maakt u een map op de server.
CFtpConnection::GetCurrentDirectory Hiermee haalt u de huidige map voor deze verbinding op.
CFtpConnection::GetCurrentDirectoryAsURL Hiermee haalt u de huidige map voor deze verbinding op als URL.
CFtpConnection::GetFile Hiermee haalt u een bestand op van de verbonden server
CFtpConnection::OpenFile Hiermee opent u een bestand op de verbonden server.
CFtpConnection::P utFile Hiermee plaatst u een bestand op de server.
CFtpConnection::Remove Hiermee verwijdert u een bestand van de server.
CFtpConnection::RemoveDirectory Hiermee verwijdert u de opgegeven map van de server.
CFtpConnection::Naam wijzigen Hiermee wijzigt u de naam van een bestand op de server.
CFtpConnection::SetCurrentDirectory Hiermee stelt u de huidige FTP-map in.

Opmerkingen

FTP is een van de drie internetservices die worden herkend door de MFC WinInet-klassen.

Als u wilt communiceren met een FTP-internetserver, moet u eerst een exemplaar van CInternetSession maken en vervolgens een CFtpConnection object maken. U maakt nooit rechtstreeks een CFtpConnection object. Roep in plaats daarvan CInternetSession::GetFtpConnection aan, waarmee het CFtpConnection object wordt gemaakt en er een aanwijzer naar wordt geretourneerd.

Zie het artikel Internetprogrammering met WinInet voor meer informatie over het CFtpConnection werken met de andere MFC-internetklassen. Zie de klassen CHttpConnection en CGopherConnection voor meer informatie over het communiceren met de andere twee ondersteunde services, HTTP en gopher.

Example

Zie het voorbeeld in het overzicht van de klasse CFtpFileFind .

Overnamehiërarchie

CObject

CInternetConnection

CFtpConnection

Requirements

Koptekst: afxinet.h

CFtpConnection::CFtpConnection

Deze lidfunctie wordt aangeroepen om een CFtpConnection object te maken.

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);

Parameterwaarden

pSession
Een aanwijzer naar het gerelateerde CInternetSession-object .

hConnected
De Windows-ingang van de huidige internetsessie.

pstrServer
Een aanwijzer naar een tekenreeks met de naam van de FTP-server.

dwContext
De context-id voor de bewerking. dwContext identificeert de statusinformatie van de bewerking die wordt geretourneerd door CInternetSession::OnStatusCallback. De standaardwaarde is ingesteld op 1; U kunt echter expliciet een specifieke context-id toewijzen voor de bewerking. Het object en alle werkzaamheden die het doet, worden gekoppeld aan die context-id.

pstrUserName
Aanwijzer naar een door null beëindigde tekenreeks waarmee de naam van de gebruiker wordt opgegeven die moet worden aangemeld. Als NULL is, is de standaardwaarde anoniem.

pstrPassword
Een aanwijzer naar een door null beëindigde tekenreeks waarmee het wachtwoord wordt opgegeven dat moet worden gebruikt om u aan te melden. Als zowel pstrPassword als pstrUserName NULL zijn, is het standaard anonieme wachtwoord de e-mailadresnaam van de gebruiker. Als pstrPassword NULL (of een lege tekenreeks) is, maar pstrUserName niet NULL is, wordt een leeg wachtwoord gebruikt. In de volgende tabel wordt het gedrag beschreven voor de vier mogelijke instellingen van pstrUserName en pstrPassword:

pstrUserName pstrPassword Gebruikersnaam verzonden naar FTP-server Wachtwoord verzonden naar FTP-server
NULL of " " NULL of " " "anoniem" E-mailnaam van gebruiker
Niet-NULL-tekenreeks NULL of " " pstrUserName " "
NULL-tekenreeks die niet null is ERROR ERROR
Niet-NULL-tekenreeks Niet-NULL-tekenreeks pstrUserName pstrPassword

nPort
Een getal dat de TCP/IP-poort identificeert die op de server moet worden gebruikt.

bPassive
Hiermee geeft u de passieve of actieve modus voor deze FTP-sessie. Als deze optie is ingesteld op TRUE, wordt de Win32-API dwFlag ingesteld op INTERNET_FLAG_PASSIVE.

Opmerkingen

U maakt nooit rechtstreeks een CFtpConnection object. Roep in plaats daarvan CInternetSession::GetFtpConnection aan, waarmee het CFptConnection object wordt gemaakt.

CFtpConnection::Command

Hiermee wordt een opdracht rechtstreeks naar een FTP-server verzonden.

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

Parameterwaarden

pszCommand
Een aanwijzer naar een tekenreeks die de opdracht bevat die moet worden verzonden.

eResponse
Hiermee geeft u op of een antwoord wordt verwacht van de FTP-server. Dit kan een van de volgende waarden zijn:

  • CmdRespNone Er wordt geen antwoord verwacht.
  • CmdRespRead Er wordt een antwoord verwacht.
  • CmdRespWrite Niet gebruikt.

Het CmdResponseType is lid van CFtpConnection, gedefinieerd in afxinet.h.

dwFlags
Een waarde met de vlaggen waarmee deze functie wordt bepaald. Zie FTPCommand voor een volledige lijst.

dwContext
Een aanwijzer naar een waarde die een toepassingsgedefinieerde waarde bevat die wordt gebruikt om de toepassingscontext in callbacks te identificeren.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van de functie FTPCommand geëmuleren, zoals beschreven in de Windows SDK.

Als er een fout optreedt, genereert MFC een uitzondering van het type CInternetException.

CFtpConnection::CreateDirectory

Roep deze lidfunctie aan om een map te maken op de verbonden server.

BOOL CreateDirectory(LPCTSTR pstrDirName);

Parameterwaarden

pstrDirName
Een aanwijzer naar een tekenreeks met de naam van de map die moet worden gemaakt.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Windows-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

Gebruik GetCurrentDirectory dit om de huidige werkmap voor deze verbinding met de server te bepalen. Neem niet aan dat het externe systeem u heeft verbonden met de hoofdmap.

De pstrDirName parameter kan een gedeeltelijk of een volledig gekwalificeerde bestandsnaam zijn ten opzichte van de huidige map. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. CreateDirectory vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat ze worden gebruikt.

CFtpConnection::GetCurrentDirectory

Roep deze lidfunctie aan om de naam van de huidige map op te halen.

BOOL GetCurrentDirectory(CString& strDirName) const;

BOOL GetCurrentDirectory(
    LPTSTR pstrDirName,
    LPDWORD lpdwLen) const;

Parameterwaarden

strDirName
Een verwijzing naar een tekenreeks die de naam van de map ontvangt.

pstrDirName
Een aanwijzer naar een tekenreeks die de naam van de map ontvangt.

lpdwLen
Een aanwijzer naar een DWORD die de volgende informatie bevat:

Bij invoer: De grootte van de buffer waarnaar wordt verwezen door pstrDirName.

Bij retour: het aantal tekens dat is opgeslagen in pstrDirName. Als de lidfunctie mislukt en ERROR_INSUFFICIENT_BUFFER wordt geretourneerd, bevat lpdwLen het aantal bytes dat de toepassing moet toewijzen om de tekenreeks te ontvangen.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

Als u in plaats daarvan de mapnaam als URL wilt ophalen, roept u GetCurrentDirectoryAsURL aan.

De parameters pstrDirName of strDirName kunnen gedeeltelijk gekwalificeerde bestandsnamen zijn ten opzichte van de huidige map of volledig gekwalificeerde bestandsnamen. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. GetCurrentDirectory vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat ze worden gebruikt.

CFtpConnection::GetCurrentDirectoryAsURL

Roep deze lidfunctie aan om de naam van de huidige map op te halen als EEN URL.

BOOL GetCurrentDirectoryAsURL(CString& strDirName) const;

BOOL GetCurrentDirectoryAsURL(
    LPTSTR pstrName,
    LPDWORD lpdwLen) const;

Parameterwaarden

strDirName
Een verwijzing naar een tekenreeks die de naam van de map ontvangt.

pstrDirName
Een aanwijzer naar een tekenreeks die de naam van de map ontvangt.

lpdwLen
Een aanwijzer naar een DWORD die de volgende informatie bevat:

Bij invoer: De grootte van de buffer waarnaar wordt verwezen door pstrDirName.

Bij retour: het aantal tekens dat is opgeslagen in pstrDirName. Als de lidfunctie mislukt en ERROR_INSUFFICIENT_BUFFER wordt geretourneerd, bevat lpdwLen het aantal bytes dat de toepassing moet toewijzen om de tekenreeks te ontvangen.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

GetCurrentDirectoryAsURL gedraagt zich hetzelfde als GetCurrentDirectory

De parameter strDirName kan gedeeltelijk gekwalificeerde bestandsnamen zijn ten opzichte van de huidige map of volledig gekwalificeerd. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. GetCurrentDirectoryAsURL vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat ze worden gebruikt.

CFtpConnection::GetFile

Roep deze lidfunctie aan om een bestand op te halen van een FTP-server en op te slaan op de lokale computer.

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

Parameterwaarden

pstrRemoteFile
Een aanwijzer naar een door null beëindigde tekenreeks met de naam van een bestand dat moet worden opgehaald van de FTP-server.

pstrLocalFile
Een aanwijzer naar een door null beëindigde tekenreeks met de naam van het bestand dat moet worden gemaakt op het lokale systeem.

bFailIfExists
Hiermee wordt aangegeven of de bestandsnaam al door een bestaand bestand kan worden gebruikt. Als de lokale bestandsnaam al bestaat en deze parameter TRUE is, GetFile mislukt het. GetFile Anders wordt de bestaande kopie van het bestand gewist.

dwAttributes
Geeft de kenmerken van het bestand aan. Dit kan elke combinatie zijn van de volgende FILE_ATTRIBUTE_* vlaggen.

  • FILE_ATTRIBUTE_ARCHIVE Het bestand is een archiefbestand. Toepassingen gebruiken dit kenmerk om bestanden te markeren voor back-up of verwijdering.

  • FILE_ATTRIBUTE_COMPRESSED Het bestand of de map is gecomprimeerd. Voor een bestand betekent compressie dat alle gegevens in het bestand worden gecomprimeerd. Voor een map is compressie de standaardinstelling voor nieuw gemaakte bestanden en submappen.

  • FILE_ATTRIBUTE_DIRECTORY Het bestand is een map.

  • FILE_ATTRIBUTE_NORMAL Het bestand heeft geen andere kenmerken ingesteld. Dit kenmerk is alleen geldig als dit alleen wordt gebruikt. Alle andere bestandskenmerken overschrijven FILE_ATTRIBUTE_NORMAL:

  • FILE_ATTRIBUTE_HIDDEN Het bestand is verborgen. Het is niet opgenomen in een gewone lijst met mappen.

  • FILE_ATTRIBUTE_READONLY Het bestand is alleen-lezen. Toepassingen kunnen het bestand lezen, maar kunnen er niet naar schrijven of verwijderen.

  • FILE_ATTRIBUTE_SYSTEM Het bestand maakt deel uit van of wordt uitsluitend door het besturingssysteem gebruikt.

  • FILE_ATTRIBUTE_TEMPORARY Het bestand wordt gebruikt voor tijdelijke opslag. Toepassingen moeten alleen naar het bestand schrijven als dat absoluut noodzakelijk is. De meeste gegevens van het bestand blijven in het geheugen zonder dat ze naar de media worden gespoeld omdat het bestand binnenkort wordt verwijderd.

dwFlags
Hiermee geeft u de voorwaarden waaronder de overdracht plaatsvindt. Deze parameter kan een van de dwFlags-waarden zijn die worden beschreven in FtpGetFile in de Windows SDK.

dwContext
De context-id voor het ophalen van het bestand. Zie Opmerkingen voor meer informatie over dwContext.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

GetFile is een routine op hoog niveau die alle overhead afhandelt die is gekoppeld aan het lezen van een bestand vanaf een FTP-server en lokaal opslaat. Toepassingen die alleen bestandsgegevens ophalen of waarvoor een nauwe controle over de bestandsoverdracht is vereist, moeten in plaats daarvan CInternetFile::Read worden gebruiktOpenFile.

Als dwFlags is FILE_TRANSFER_TYPE_ASCII, converteert de vertaling van bestandsgegevens ook besturings- en opmaaktekens naar Windows-equivalenten. De standaardoverdracht is de binaire modus, waarbij het bestand wordt gedownload in dezelfde indeling als het wordt opgeslagen op de server.

Zowel pstrRemoteFile als pstrLocalFile kunnen gedeeltelijk gekwalificeerde bestandsnamen zijn ten opzichte van de huidige map of volledig gekwalificeerde bestandsnamen. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. GetFile vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat ze worden gebruikt.

Overschrijf de dwContext-standaardinstelling om de context-id in te stellen op een waarde van uw keuze. De context-id is gekoppeld aan deze specifieke bewerking van het object dat is gemaakt door het CFtpConnectionCInternetSession-object . De waarde wordt geretourneerd naar CInternetSession::OnStatusCallback om de status op te geven van de bewerking waarmee deze wordt geïdentificeerd. Zie het artikel Internet First Steps: WinInet voor meer informatie over de context-id.

CFtpConnection::OpenFile

Roep deze lidfunctie aan om een bestand op een FTP-server te openen voor lezen of schrijven.

CInternetFile* OpenFile(
    LPCTSTR pstrFileName,
    DWORD dwAccess = GENERIC_READ,
    DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
    DWORD_PTR dwContext = 1);

Parameterwaarden

pstrFileName
Een aanwijzer naar een tekenreeks met de naam van het te openen bestand.

dwAccess
Bepaalt hoe het bestand wordt geopend. Kan GENERIC_READ of GENERIC_WRITE zijn, maar niet beide.

dwFlags
Hiermee geeft u de voorwaarden waaronder volgende overdrachten plaatsvinden. Dit kan een van de volgende FTP_TRANSFER_* constanten zijn:

  • FTP_TRANSFER_TYPE_ASCII De bestandsoverdrachten met behulp van de FTP ASCII-overdrachtsmethode (Type A). Hiermee worden besturings- en opmaakgegevens geconverteerd naar lokale equivalenten.

  • FTP_TRANSFER_TYPE_BINARY Het bestand draagt gegevens over met behulp van de overdrachtsmethode image (Type I) van FTP. Het bestand draagt gegevens precies zoals het bestaat, zonder wijzigingen. Dit is de standaardoverdrachtsmethode.

dwContext
De context-id voor het openen van het bestand. Zie Opmerkingen voor meer informatie over dwContext.

Retourwaarde

Een aanwijzer naar een CInternetFile-object .

Opmerkingen

OpenFile in de volgende situaties moet worden gebruikt:

  • Een toepassing bevat gegevens die moeten worden verzonden en gemaakt als een bestand op de FTP-server, maar die gegevens bevinden zich niet in een lokaal bestand. Wanneer OpenFile u een bestand opent, gebruikt de toepassing CInternetFile::Write om de FTP-bestandsgegevens naar de server te verzenden.

  • Een toepassing moet een bestand van de server ophalen en in het door de toepassing beheerde geheugen plaatsen in plaats van het naar de schijf te schrijven. De toepassing maakt gebruik van CInternetFile::Read na het openen OpenFile van het bestand.

  • Een toepassing heeft een nauwkeurig controleniveau nodig over een bestandsoverdracht. De toepassing kan bijvoorbeeld een voortgangsbeheer willen weergeven om de voortgang van de status van de bestandsoverdracht aan te geven tijdens het downloaden van een bestand.

Na het aanroepen en tot het aanroepen OpenFileCInternetFile::Close, kan de toepassing alleen CInternetFile::Read, CInternetFile::Write, CInternetConnection::Closeof CFtpFileFind::FindFile aanroepen. Aanroepen naar andere FTP-functies voor dezelfde FTP-sessie mislukken en stellen de foutcode in op FTP_ETRANSFER_IN_PROGRESS.

De parameter pstrFileName kan een gedeeltelijk gekwalificeerde bestandsnaam zijn ten opzichte van de huidige map of volledig gekwalificeerd. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. OpenFile vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat u deze gebruikt.

Overschrijf de dwContext-standaardinstelling om de context-id in te stellen op een waarde van uw keuze. De context-id is gekoppeld aan deze specifieke bewerking van het object dat is gemaakt door het CFtpConnectionCInternetSession-object . De waarde wordt geretourneerd naar CInternetSession::OnStatusCallback om de status op te geven van de bewerking waarmee deze wordt geïdentificeerd. Zie het artikel Internet First Steps: WinInet voor meer informatie over de context-id.

CFtpConnection::P utFile

Roep deze lidfunctie aan om een bestand op te slaan op een FTP-server.

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

Parameterwaarden

pstrLocalFile
Een aanwijzer naar een tekenreeks met de naam van het bestand dat moet worden verzonden vanuit het lokale systeem.

pstrRemoteFile
Een aanwijzer naar een tekenreeks met de naam van het bestand dat moet worden gemaakt op de FTP-server.

dwFlags
Hiermee geeft u de voorwaarden waaronder de overdracht van het bestand plaatsvindt. Kan een van de FTP_TRANSFER_* constanten zijn die worden beschreven in OpenFile.

dwContext
De context-id voor het plaatsen van het bestand. Zie Opmerkingen voor meer informatie over dwContext.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

PutFile is een routine op hoog niveau die alle bewerkingen verwerkt die zijn gekoppeld aan het opslaan van een bestand op een FTP-server. Toepassingen die alleen gegevens verzenden of die een betere controle over de bestandsoverdracht vereisen, moeten Gebruikmaken van OpenFile en CInternetFile::Write.

Overschrijf de dwContext standaardinstelling om de context-id in te stellen op een waarde van uw keuze. De context-id is gekoppeld aan deze specifieke bewerking van het object dat is gemaakt door het CFtpConnectionCInternetSession-object . De waarde wordt geretourneerd naar CInternetSession::OnStatusCallback om de status op te geven van de bewerking waarmee deze wordt geïdentificeerd. Zie het artikel Internet First Steps: WinInet voor meer informatie over de context-id.

CFtpConnection::Remove

Roep deze lidfunctie aan om het opgegeven bestand van de verbonden server te verwijderen.

BOOL Remove(LPCTSTR pstrFileName);

Parameterwaarden

pstrFileName
Een aanwijzer naar een tekenreeks met de bestandsnaam die u wilt verwijderen.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

De parameter pstrFileName kan een gedeeltelijk gekwalificeerde bestandsnaam zijn ten opzichte van de huidige map of volledig gekwalificeerd. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. De Remove functie vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat ze worden gebruikt.

CFtpConnection::RemoveDirectory

Roep deze lidfunctie aan om de opgegeven map van de verbonden server te verwijderen.

BOOL RemoveDirectory(LPCTSTR pstrDirName);

Parameterwaarden

pstrDirName
Een aanwijzer naar een tekenreeks die de map bevat die moet worden verwijderd.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

Gebruik GetCurrentDirectory om de huidige werkmap van de server te bepalen. Neem niet aan dat het externe systeem u heeft verbonden met de hoofdmap.

De parameter pstrDirName kan een gedeeltelijk of volledig gekwalificeerde bestandsnaam zijn ten opzichte van de huidige map. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. RemoveDirectory vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat ze worden gebruikt.

CFtpConnection::Naam wijzigen

Roep deze lidfunctie aan om de naam van het opgegeven bestand op de verbonden server te wijzigen.

BOOL Rename(
    LPCTSTR pstrExisting,
    LPCTSTR pstrNew);

Parameterwaarden

pstrExisting
Een aanwijzer naar een tekenreeks met de huidige naam van het bestand waarvan de naam moet worden gewijzigd.

pstrNew
Een aanwijzer naar een tekenreeks met de nieuwe naam van het bestand.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

De parameters pstrExisting en pstrNew kunnen een gedeeltelijk gekwalificeerde bestandsnaam zijn ten opzichte van de huidige map of volledig gekwalificeerde bestandsnaam. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. Rename vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat ze worden gebruikt.

CFtpConnection::SetCurrentDirectory

Roep deze lidfunctie aan om over te schakelen naar een andere map op de FTP-server.

BOOL SetCurrentDirectory(LPCTSTR pstrDirName);

Parameterwaarden

pstrDirName
Een aanwijzer naar een tekenreeks die de naam van de map bevat.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Opmerkingen

De parameter pstrDirName kan een gedeeltelijk of volledig gekwalificeerde bestandsnaam zijn ten opzichte van de huidige map. Een backslash (\) of slash (/) kan worden gebruikt als het adreslijstscheidingsteken voor een van beide namen. SetCurrentDirectory vertaalt de scheidingstekens voor mapnamen naar de juiste tekens voordat ze worden gebruikt.

Gebruik GetCurrentDirectory om de huidige werkmap van een FTP-server te bepalen. Neem niet aan dat het externe systeem u heeft verbonden met de hoofdmap.

Zie ook

CInternetConnection-klasse
Hiërarchiegrafiek
CInternetConnection-klasse
CInternetSession-klasse

  • Last updated on