Megosztás a következőn keresztül:

CFtpConnection osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Kezeli az FTP-kapcsolatot egy internetes kiszolgálóval, és lehetővé teszi a címtárak és fájlok közvetlen kezelését a kiszolgálón.

Szemantika

class CFtpConnection : public CInternetConnection

Tagok

Nyilvános konstruktorok

Név Description
CFtpConnection::CFtpConnection Egy CFtpConnection objektumot hoz létre.

Nyilvános metódusok

Név Description
CFtpConnection::Command Parancsot küld közvetlenül egy FTP-kiszolgálónak.
CFtpConnection::CreateDirectory Létrehoz egy könyvtárat a kiszolgálón.
CFtpConnection::GetCurrentDirectory Lekéri a kapcsolat aktuális könyvtárát.
CFtpConnection::GetCurrentDirectoryAsURL Lekéri a kapcsolat aktuális könyvtárát URL-címként.
CFtpConnection::GetFile Fájl lekérése a csatlakoztatott kiszolgálóról
CFtpConnection::OpenFile Fájl megnyitása a csatlakoztatott kiszolgálón.
CFtpConnection::P utFile Fájlokat helyez el a kiszolgálón.
CFtpConnection::Remove Eltávolít egy fájlt a kiszolgálóról.
CFtpConnection::RemoveDirectory Eltávolítja a megadott könyvtárat a kiszolgálóról.
CFtpConnection::Átnevezés Átnevez egy fájlt a kiszolgálón.
CFtpConnection::SetCurrentDirectory Beállítja az aktuális FTP-könyvtárat.

Megjegyzések

Az FTP az MFC WinInet-osztályok által felismert három internetes szolgáltatás egyike.

Az FTP internetkiszolgálóval való kommunikációhoz először létre kell hoznia egy CInternetSession-példányt, majd létre kell hoznia egy CFtpConnection objektumot. Soha nem hoz létre közvetlenül objektumot CFtpConnection , ehelyett hívja meg a CInternetSession::GetFtpConnection parancsot, amely létrehozza az CFtpConnection objektumot, és egy mutatót ad vissza.

Ha többet szeretne megtudni arról, hogyan CFtpConnection működik a többi MFC internetes osztály, olvassa el az Internet Programming with WinInet című cikket. A másik két támogatott szolgáltatással, a HTTP-vel és a gopherrel való kommunikációról további információt a CHttpConnection és a CGopherConnection osztályban talál.

Example

Tekintse meg a példát a CFtpFileFind osztály áttekintésében.

Öröklési hierarchia

CObject

CInternetConnection

CFtpConnection

Requirements

Fejléc: afxinet.h

CFtpConnection::CFtpConnection

Ez a tagfüggvény egy CFtpConnection objektum létrehozásához van meghívva.

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

Paraméterek

pSession
Mutató a kapcsolódó CInternetSession objektumra.

hConnected
Az aktuális internetes munkamenet Windows-kezelője.

pstrServer
Az FTP-kiszolgáló nevét tartalmazó sztringre mutató mutató.

dwContext
A művelet környezeti azonosítója. A dwContext azonosítja a CInternetSession::OnStatusCallback által visszaadott művelet állapotadatait. Az alapértelmezett érték 1; azonban explicit módon hozzárendelhet egy adott környezeti azonosítót a művelethez. Az objektum és az általa végzett munka ehhez a környezeti azonosítóhoz lesz társítva.

pstrUserName
Mutasson egy null értékű sztringre, amely megadja a bejelentkezni kívánt felhasználó nevét. Null érték esetén az alapértelmezett érték névtelen.

pstrPassword
Egy null értékű sztringre mutató mutató, amely megadja a bejelentkezéshez használni kívánt jelszót. Ha a pstrPassword és a pstrUserName is NULL értékű, az alapértelmezett névtelen jelszó a felhasználó e-mail-neve. Ha a pstrPassword NULL (vagy üres sztring), de a pstrUserName nem NULL, a rendszer üres jelszót használ. Az alábbi táblázat a pstrUserName és a pstrPassword négy lehetséges beállításának viselkedését ismerteti:

pstrUserName pstrPassword FTP-kiszolgálónak küldött felhasználónév FTP-kiszolgálónak küldött jelszó
NULL vagy " " NULL vagy " " "névtelen" A felhasználó e-mail-címe
Nem NULL sztring NULL vagy " " pstrUserName " "
NULL nem NULL sztring ERROR ERROR
Nem NULL sztring Nem NULL sztring pstrUserName pstrPassword

nPort
A kiszolgálón használandó TCP/IP-portot azonosító szám.

bPassive
Passzív vagy aktív módot ad meg ehhez az FTP-munkamenethez. Ha IGAZ értékre van állítva, a Win32 API dwFlag értéke INTERNET_FLAG_PASSIVE.

Megjegyzések

Soha nem hozhat létre közvetlenül objektumot CFtpConnection . Ehelyett hívja meg a CInternetSession::GetFtpConnection parancsot, amely létrehozza az CFptConnection objektumot.

CFtpConnection::Command

Parancsot küld közvetlenül egy FTP-kiszolgálónak.

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

Paraméterek

pszCommand
Az elküldendő parancsot tartalmazó sztringre mutató mutató.

eResponse
Megadja, hogy az FTP-kiszolgálótól várható-e válasz. Az alábbi értékek egyike lehet:

  • CmdRespNone Nem várható válasz.
  • CmdRespRead Válasz várható.
  • CmdRespWrite Nincs használatban.

A CmdResponseType az afxinet.h fájlban definiált CFtpConnection tagja.

dwFlags
A függvényt vezérlő jelzőket tartalmazó érték. A teljes listát az FTPCommand webhelyen találja.

dwContext
Egy olyan értékre mutató mutató, amely egy alkalmazás által definiált értéket tartalmaz, amellyel azonosíthatja az alkalmazáskörnyezetet a visszahívásokban.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény az FTPCommand függvény funkcióit emulálja a Windows SDK-ban leírtak szerint.

Ha hiba történik, az MFC kivételt ad a CInternetException típusból.

CFtpConnection::CreateDirectory

A tagfüggvény meghívásával hozzon létre egy könyvtárat a csatlakoztatott kiszolgálón.

BOOL CreateDirectory(LPCTSTR pstrDirName);

Paraméterek

pstrDirName
A létrehozandó könyvtár nevét tartalmazó sztringre mutató mutató.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Windows GetLastError függvény meghívható a hiba okának meghatározásához.

Megjegyzések

A kiszolgálóval való kapcsolat aktuális munkakönyvtárának meghatározására szolgál GetCurrentDirectory . Ne feltételezzük, hogy a távoli rendszer csatlakoztatta Önt a gyökérkönyvtárhoz.

A pstrDirName paraméter lehet részben vagy teljesen minősített fájlnév az aktuális könyvtárhoz képest. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. CreateDirectory lefordítja a címtárnévelválasztókat a megfelelő karakterekre a használat előtt.

CFtpConnection::GetCurrentDirectory

Hívja meg ezt a tagfüggvényt az aktuális könyvtár nevének lekéréséhez.

BOOL GetCurrentDirectory(CString& strDirName) const;

BOOL GetCurrentDirectory(
    LPTSTR pstrDirName,
    LPDWORD lpdwLen) const;

Paraméterek

strDirName
Hivatkozás egy olyan sztringre, amely megkapja a könyvtár nevét.

pstrDirName
Egy olyan sztringre mutató mutató, amely megkapja a könyvtár nevét.

lpdwLen
Mutató egy DWORD-hez, amely a következő információkat tartalmazza:

Bejegyzéskor: A pstrDirName által hivatkozott puffer mérete.

Visszatéréskor: A pstrDirName fájlban tárolt karakterek száma. Ha a tagfüggvény meghiúsul, és ERROR_INSUFFICIENT_BUFFER ad vissza, akkor az lpdwLen az alkalmazás által a sztring fogadásához lefoglalt bájtok számát tartalmazza.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

Megjegyzések

A címtárnév URL-címként való lekéréséhez hívja meg a GetCurrentDirectoryAsURL parancsot.

A pstrDirName vagy strDirName paraméterek lehetnek részben minősített fájlnevek az aktuális könyvtárhoz képest, vagy teljes mértékben minősítettek. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. GetCurrentDirectory lefordítja a címtárnévelválasztókat a megfelelő karakterekre a használat előtt.

CFtpConnection::GetCurrentDirectoryAsURL

Hívja meg ezt a tagfüggvényt az aktuális könyvtár nevének URL-címként való lekéréséhez.

BOOL GetCurrentDirectoryAsURL(CString& strDirName) const;

BOOL GetCurrentDirectoryAsURL(
    LPTSTR pstrName,
    LPDWORD lpdwLen) const;

Paraméterek

strDirName
Hivatkozás egy olyan sztringre, amely megkapja a könyvtár nevét.

pstrDirName
Egy olyan sztringre mutató mutató, amely megkapja a könyvtár nevét.

lpdwLen
Mutató egy DWORD-hez, amely a következő információkat tartalmazza:

Bejegyzéskor: A pstrDirName által hivatkozott puffer mérete.

Visszatéréskor: A pstrDirName fájlban tárolt karakterek száma. Ha a tagfüggvény meghiúsul, és ERROR_INSUFFICIENT_BUFFER ad vissza, akkor az lpdwLen az alkalmazás által a sztring fogadásához lefoglalt bájtok számát tartalmazza.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

Megjegyzések

GetCurrentDirectoryAsURL ugyanúgy viselkedik, mint a GetCurrentDirectory

Az strDirName paraméter lehet részben minősített fájlnév az aktuális könyvtárhoz képest, vagy teljes mértékben minősített. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. GetCurrentDirectoryAsURL lefordítja a címtárnévelválasztókat a megfelelő karakterekre a használat előtt.

CFtpConnection::GetFile

Hívja meg ezt a tagfüggvényt, hogy lekérjen egy fájlt egy FTP-kiszolgálóról, és tárolja a helyi gépen.

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

Paraméterek

pstrRemoteFile
Az FTP-kiszolgálóról lekérendő fájl nevét tartalmazó null értékű sztringre mutató mutató.

pstrLocalFile
Mutató egy null értékű sztringre, amely a helyi rendszeren létrehozandó fájl nevét tartalmazza.

bFailIfExists
Azt jelzi, hogy a fájlnevet már használhatja-e már egy meglévő fájl. Ha a helyi fájlnév már létezik, és ez a paraméter IGAZ, GetFile sikertelen lesz. GetFile Ellenkező esetben törli a fájl meglévő példányát.

dwAttributes
A fájl attribútumait jelzi. Ez a következő FILE_ATTRIBUTE_* jelzők bármilyen kombinációját jelentheti.

  • FILE_ATTRIBUTE_ARCHIVE A fájl egy archív fájl. Az alkalmazások ezzel az attribútummal jelölik meg a fájlokat biztonsági mentésre vagy eltávolításra.

  • FILE_ATTRIBUTE_COMPRESSED A fájl vagy könyvtár tömörítve van. Egy fájl esetében a tömörítés azt jelenti, hogy a fájl összes adata tömörítve van. A címtárak esetében a tömörítés az újonnan létrehozott fájlok és alkönyvtárak alapértelmezett értéke.

  • FILE_ATTRIBUTE_DIRECTORY A fájl egy könyvtár.

  • FILE_ATTRIBUTE_NORMAL A fájlnak nincs más attribútuma. Ez az attribútum csak akkor érvényes, ha egyedül használja. Az összes többi fájlattribútum felülbírálja FILE_ATTRIBUTE_NORMAL:

  • FILE_ATTRIBUTE_HIDDEN A fájl rejtett. Ez nem szerepelhet a szokásos címtárak listájában.

  • FILE_ATTRIBUTE_READONLY A fájl írásvédett. Az alkalmazások beolvashatják a fájlt, de nem tudnak írni vagy törölni.

  • FILE_ATTRIBUTE_SYSTEM A fájl az operációs rendszer része, vagy kizárólag az operációs rendszer használja.

  • FILE_ATTRIBUTE_TEMPORARY A fájl ideiglenes tárolásra van használva. Az alkalmazásoknak csak akkor kell írniuk a fájlba, ha feltétlenül szükséges. A fájl adatainak többsége a memóriában marad anélkül, hogy az adathordozóra kerül, mert a fájl hamarosan törlődik.

dwFlags
Megadja az átvitel feltételeit. Ez a paraméter a Windows SDK FtpGetFile fájljában leírt dwFlags értékek bármelyike lehet.

dwContext
A fájllekérés környezetazonosítója. A dwContextről további információt a Megjegyzések című témakörben talál.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

Megjegyzések

GetFile Egy magas szintű rutin, amely kezeli a fájlok FTP-kiszolgálóról való olvasásával és helyi tárolásával kapcsolatos összes terhelést. Azokat az alkalmazásokat, amelyek csak fájladatokat kérnek le, vagy amelyek szoros ellenőrzést igényelnek a fájlátvitel felett, a CInternetFile::Read parancsot kell használniukOpenFile.

Ha a dwFlags FILE_TRANSFER_TYPE_ASCII, a fájladatok fordítása a vezérlő- és formázási karaktereket is Windows-megfelelőkké alakítja. Az alapértelmezett átvitel bináris mód, ahol a fájl a kiszolgálón tárolt formátumban lesz letöltve.

A pstrRemoteFile és a pstrLocalFile is lehet részben minősített fájlnév az aktuális könyvtárhoz képest, vagy teljes mértékben minősített. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. GetFile lefordítja a címtárnévelválasztókat a megfelelő karakterekre a használat előtt.

Felülbírálja a dwContext alapértelmezett értékét, hogy a környezetazonosítót az Ön által választott értékre állítsa. A környezetazonosító a CInternetSession objektum által létrehozott objektum adott műveletéhez CFtpConnection van társítva. A rendszer visszaadja az értéket a CInternetSession::OnStatusCallback függvénynek, hogy állapotot adjon meg azon műveleten, amellyel azonosítva van. A környezetazonosítóval kapcsolatos további információkért tekintse meg az internet első lépései: WinInet című cikket.

CFtpConnection::OpenFile

Hívja meg ezt a tagfüggvényt egy FTP-kiszolgálón található fájl olvasáshoz vagy íráshoz való megnyitásához.

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

Paraméterek

pstrFileName
Mutató a megnyitni kívánt fájl nevét tartalmazó sztringre.

dwAccess
Meghatározza a fájl elérésének módját. Lehet GENERIC_READ vagy GENERIC_WRITE, de mindkettő nem.

dwFlags
Megadja azokat a feltételeket, amelyek mellett a későbbi átvitelek történnek. Ez a következő FTP_TRANSFER_* állandók bármelyike lehet:

  • FTP_TRANSFER_TYPE_ASCII A fájlátvitel FTP ASCII (A típus) átviteli módszerrel. A vezérlő- és formázási adatokat helyi megfelelőkké alakítja.

  • FTP_TRANSFER_TYPE_BINARY A fájl ftp-lemezkép (I. típus) átviteli módszerrel továbbítja az adatokat. A fájl pontosan úgy továbbítja az adatokat, ahogy létezik, módosítás nélkül. Ez az alapértelmezett átviteli módszer.

dwContext
A fájl megnyitásának környezeti azonosítója. A dwContextről további információt a Megjegyzések című témakörben talál.

Visszaadott érték

Egy CInternetFile-objektumra mutató mutató.

Megjegyzések

OpenFile a következő helyzetekben kell használni:

  • Az alkalmazások olyan adatokkal rendelkeznek, amelyeket fájlként kell elküldeni és létrehozni az FTP-kiszolgálón, de ezek az adatok nem egy helyi fájlban vannak. Miután OpenFile megnyitja a fájlt, az alkalmazás a CInternetFile::Write parancsot használja az FTP-fájladatok kiszolgálóra való küldéséhez.

  • Egy alkalmazásnak le kell kérnie egy fájlt a kiszolgálóról, és az alkalmazás által vezérelt memóriába kell helyeznie ahelyett, hogy lemezre íratta volna. Az alkalmazás a CInternetFile::Read fájlt OpenFile használja a fájl megnyitása után.

  • Egy alkalmazásnak finom szintű vezérlésre van szüksége a fájlátvitel felett. Előfordulhat például, hogy az alkalmazás egy folyamatjelzőt szeretne megjeleníteni, amely jelzi a fájlátviteli állapot állapotát a fájl letöltése közben.

A hívás OpenFile után és a hívásig CInternetFile::Closeaz alkalmazás csak a CInternetFile::Olvasás, CInternetFile::Írás, CInternetConnection::Closevagy CFtpFileFind::FindFile meghívására képes. Ugyanazon FTP-munkamenet más FTP-függvényeinek hívásai sikertelenek lesznek, és a hibakódot FTP_ETRANSFER_IN_PROGRESS értékre állítja.

A pstrFileName paraméter lehet részben minősített fájlnév az aktuális könyvtárhoz képest, vagy teljes mértékben minősített. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. OpenFile a címtárnévelválasztókat a megfelelő karakterekre fordítja a használat előtt.

Felülbírálja a dwContext alapértelmezett értékét, hogy a környezetazonosítót az Ön által választott értékre állítsa. A környezetazonosító a CInternetSession objektum által létrehozott objektum adott műveletéhez CFtpConnection van társítva. A rendszer visszaadja az értéket a CInternetSession::OnStatusCallback függvénynek, hogy állapotot adjon meg azon műveleten, amellyel azonosítva van. A környezetazonosítóval kapcsolatos további információkért tekintse meg az internet első lépései: WinInet című cikket.

CFtpConnection::P utFile

A tagfüggvény meghívása fájl FTP-kiszolgálón való tárolásához.

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

Paraméterek

pstrLocalFile
Mutató a helyi rendszerből küldendő fájl nevét tartalmazó sztringre.

pstrRemoteFile
Mutató az FTP-kiszolgálón létrehozandó fájl nevét tartalmazó sztringre.

dwFlags
Megadja a fájl átvitelének feltételeit. Az OpenFile-ban leírt FTP_TRANSFER_* állandók bármelyike lehet.

dwContext
A fájl elhelyezésének környezeti azonosítója. A dwContextről további információt a Megjegyzések című témakörben talál.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

Megjegyzések

PutFile egy magas szintű rutin, amely kezeli a fájlok FTP-kiszolgálón való tárolásához kapcsolódó összes műveletet. Azokat az alkalmazásokat, amelyek csak adatokat küldenek, vagy amelyek szorosabb ellenőrzést igényelnek a fájlátvitel felett, az OpenFile és a CInternetFile::Write parancsot kell használniuk.

Felülbírálja az dwContext alapértelmezett beállítást, ha a környezetazonosítót egy ön által választott értékre állítja. A környezetazonosító a CInternetSession objektum által létrehozott objektum adott műveletéhez CFtpConnection van társítva. A rendszer visszaadja az értéket a CInternetSession::OnStatusCallback függvénynek, hogy állapotot adjon meg azon műveleten, amellyel azonosítva van. A környezetazonosítóval kapcsolatos további információkért tekintse meg az internet első lépései: WinInet című cikket.

CFtpConnection::Remove

Hívja meg ezt a tagfüggvényt, hogy törölje a megadott fájlt a csatlakoztatott kiszolgálóról.

BOOL Remove(LPCTSTR pstrFileName);

Paraméterek

pstrFileName
Az eltávolítandó fájlnevet tartalmazó sztringre mutató mutató.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

Megjegyzések

A pstrFileName paraméter lehet részben minősített fájlnév az aktuális könyvtárhoz képest, vagy teljes mértékben minősített. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. A Remove függvény a címtárnévelválasztókat a megfelelő karakterekre fordítja a használat előtt.

CFtpConnection::RemoveDirectory

A tagfüggvény meghívásával távolítsa el a megadott könyvtárat a csatlakoztatott kiszolgálóról.

BOOL RemoveDirectory(LPCTSTR pstrDirName);

Paraméterek

pstrDirName
Az eltávolítandó könyvtárat tartalmazó sztringre mutató mutató.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

Megjegyzések

A GetCurrentDirectory használatával állapítsa meg a kiszolgáló aktuális munkakönyvtárát. Ne feltételezzük, hogy a távoli rendszer csatlakoztatta Önt a gyökérkönyvtárhoz.

A pstrDirName paraméter lehet részben vagy teljesen minősített fájlnév az aktuális könyvtárhoz képest. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. RemoveDirectory lefordítja a címtárnévelválasztókat a megfelelő karakterekre a használat előtt.

CFtpConnection::Átnevezés

Hívja meg ezt a tagfüggvényt a csatlakoztatott kiszolgálón megadott fájl átnevezéséhez.

BOOL Rename(
    LPCTSTR pstrExisting,
    LPCTSTR pstrNew);

Paraméterek

pstrExisting
Az átnevezni kívánt fájl aktuális nevét tartalmazó sztringre mutató mutató.

pstrNew
A fájl új nevét tartalmazó sztringre mutató mutató.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

Megjegyzések

A pstrExisting és a pstrNew paraméter lehet részben minősített fájlnév az aktuális könyvtárhoz képest, vagy teljes mértékben minősített. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. Rename lefordítja a címtárnévelválasztókat a megfelelő karakterekre a használat előtt.

CFtpConnection::SetCurrentDirectory

Hívja meg ezt a tagfüggvényt, hogy az FTP-kiszolgálón egy másik könyvtárra váltson.

BOOL SetCurrentDirectory(LPCTSTR pstrDirName);

Paraméterek

pstrDirName
A könyvtár nevét tartalmazó sztringre mutató mutató.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. Ha a hívás sikertelen, a Rendszer meghívhatja a Win32 GetLastError függvényt a hiba okának meghatározásához.

Megjegyzések

A pstrDirName paraméter lehet részben vagy teljesen minősített fájlnév az aktuális könyvtárhoz képest. A fordított perjel (\) vagy a perjel (/) bármelyik név könyvtárelválasztójaként használható. SetCurrentDirectory lefordítja a címtárnévelválasztókat a megfelelő karakterekre a használat előtt.

Az FTP-kiszolgáló aktuális munkakönyvtárának meghatározásához használja a GetCurrentDirectory parancsot. Ne feltételezzük, hogy a távoli rendszer csatlakoztatta Önt a gyökérkönyvtárhoz.

Lásd még

CInternetConnection osztály
hierarchiadiagram
CInternetConnection osztály
CInternetSession osztály

  • Last updated on