Udostępnij za pośrednictwem

Klasa CFtpConnection

  • Artykuł

Zarządza połączeniem FTP z serwerem internetowym i umożliwia bezpośrednie manipulowanie katalogami i plikami na tym serwerze.

Składnia

class CFtpConnection : public CInternetConnection

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CFtpConnection::CFtpConnection CFtpConnection Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CFtpConnection::Command Wysyła polecenie bezpośrednio do serwera FTP.
CFtpConnection::CreateDirectory Tworzy katalog na serwerze.
CFtpConnection::GetCurrentDirectory Pobiera bieżący katalog dla tego połączenia.
CFtpConnection::GetCurrentDirectoryAsURL Pobiera bieżący katalog dla tego połączenia jako adres URL.
CFtpConnection::GetFile Pobiera plik z połączonego serwera
CFtpConnection::OpenFile Otwiera plik na połączonym serwerze.
CFtpConnection::P utFile Umieszcza plik na serwerze.
CFtpConnection::Remove Usuwa plik z serwera.
CFtpConnection::RemoveDirectory Usuwa określony katalog z serwera.
CFtpConnection::Rename Zmienia nazwę pliku na serwerze.
CFtpConnection::SetCurrentDirectory Ustawia bieżący katalog FTP.

Uwagi

FTP to jedna z trzech usług internetowych rozpoznawanych przez klasy MFC WinInet.

Aby komunikować się z serwerem internetowym FTP, należy najpierw utworzyć wystąpienie CInternetSession, a następnie utworzyć CFtpConnection obiekt. Nigdy nie tworzysz obiektu bezpośrednio; zamiast tego wywołaj metodę CFtpConnection CInternetSession::GetFtpConnection, która tworzy CFtpConnection obiekt i zwraca do niego wskaźnik.

Aby dowiedzieć się więcej o CFtpConnection sposobie pracy z innymi klasami internetowymi MFC, zobacz artykuł Programowanie internetowe za pomocą usługi WinInet. Aby uzyskać więcej informacji na temat komunikacji z dwoma innymi obsługiwanymi usługami, http i gopher, zobacz klasy CHttpConnection i CGopherConnection.

Przykład

Zobacz przykład w przeglądzie klasy CFtpFileFind .

Hierarchia dziedziczenia

Obiekt CObject

CInternetConnection

CFtpConnection

Wymagania

Nagłówek: afxinet.h

CFtpConnection::CFtpConnection

Ta funkcja składowa jest wywoływana w celu skonstruowania CFtpConnection obiektu.

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

Parametry

PSession
Wskaźnik do powiązanego obiektu CInternetSession .

hPołączone
Obsługa systemu Windows bieżącej sesji internetowej.

pstrServer
Wskaźnik do ciągu zawierającego nazwę serwera FTP.

dwContext
Identyfikator kontekstu operacji. dwContext identyfikuje informacje o stanie operacji zwrócone przez CInternetSession::OnStatusCallback. Wartość domyślna to 1; Można jednak jawnie przypisać określony identyfikator kontekstu dla operacji. Obiekt i wszystkie wykonywane prace zostaną skojarzone z tym identyfikatorem kontekstu.

pstrUserName
Wskaźnik do ciągu zakończonego wartości null, który określa nazwę użytkownika do zalogowania. Jeśli wartość NULL, wartość domyślna to anonimowe.

pstrPassword
Wskaźnik do ciągu zakończonego wartością null, który określa hasło używane do logowania. Jeśli zarówno pstrPassword , jak i pstrUserName mają wartość NULL, domyślne anonimowe hasło to nazwa e-mail użytkownika. Jeśli parametr pstrPassword ma wartość NULL (lub pusty ciąg), ale parametr pstrUserName nie ma wartości NULL, używane jest puste hasło. W poniższej tabeli opisano zachowanie czterech możliwych ustawień pstrUserName i pstrPassword:

pstrUserName pstrPassword Nazwa użytkownika wysłana do serwera FTP Hasło wysyłane do serwera FTP
NULL lub " " NULL lub " " "anonimowy" Nazwa e-mail użytkownika
Ciąg bez wartości NULL NULL lub " " pstrUserName " "
Ciąg o wartości null inny niż NULL BŁĄD BŁĄD
Ciąg bez wartości NULL Ciąg bez wartości NULL pstrUserName pstrPassword

nPort
Numer identyfikujący port TCP/IP do użycia na serwerze.

bPassive
Określa tryb pasywny lub aktywny dla tej sesji FTP. Jeśli ustawiono wartość TRUE, ustawia wartość dwFlag interfejsu API Win32 na INTERNET_FLAG_PASSIVE.

Uwagi

Nigdy nie tworzysz CFtpConnection obiektu bezpośrednio. Zamiast tego wywołaj metodę CInternetSession::GetFtpConnection, która tworzy CFptConnection obiekt.

CFtpConnection::Command

Wysyła polecenie bezpośrednio do serwera FTP.

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

Parametry

pszCommand
Wskaźnik do ciągu zawierającego polecenie do wysłania.

eResponse
Określa, czy odpowiedź jest oczekiwana z serwera FTP. Może być jedną z następujących wartości:

  • CmdRespNone Nie oczekuje się odpowiedzi.
  • CmdRespRead Oczekiwana jest odpowiedź.
  • CmdRespWrite Nieużytne.

CmdResponseType jest elementem członkowskim CFtpConnection zdefiniowanym w pliku afxinet.h.

dwFlags
Wartość zawierająca flagi sterujące tą funkcją. Aby uzyskać pełną listę, zobacz FTPCommand.

dwContext
Wskaźnik do wartości zawierającej wartość zdefiniowaną przez aplikację służącą do identyfikowania kontekstu aplikacji w wywołaniach zwrotnych.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Ta funkcja składowa emuluje funkcjonalność funkcji FTPCommand zgodnie z opisem w zestawie WINDOWS SDK.

Jeśli wystąpi błąd, MFC zgłasza wyjątek typu CInternetException.

CFtpConnection::CreateDirectory

Wywołaj tę funkcję składową, aby utworzyć katalog na połączonym serwerze.

BOOL CreateDirectory(LPCTSTR pstrDirName);

Parametry

pstrDirName
Wskaźnik do ciągu zawierającego nazwę katalogu do utworzenia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie nie powiedzie się, funkcja GetLastError systemu Windows może zostać wywołana, aby określić przyczynę błędu.

Uwagi

Użyj GetCurrentDirectory polecenia , aby określić bieżący katalog roboczy dla tego połączenia z serwerem. Nie zakładaj, że system zdalny połączył Cię z katalogem głównym.

Parametr pstrDirName może być częściowo lub w pełni kwalifikowaną nazwą pliku względem bieżącego katalogu. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. CreateDirectory Tłumaczy separatory nazw katalogów na odpowiednie znaki przed ich zastosowaniem.

CFtpConnection::GetCurrentDirectory

Wywołaj tę funkcję składową, aby uzyskać nazwę bieżącego katalogu.

BOOL GetCurrentDirectory(CString& strDirName) const;

BOOL GetCurrentDirectory(
    LPTSTR pstrDirName,
    LPDWORD lpdwLen) const;

Parametry

strDirName
Odwołanie do ciągu, który otrzyma nazwę katalogu.

pstrDirName
Wskaźnik do ciągu, który otrzyma nazwę katalogu.

lpdwLen
Wskaźnik do DWORD zawierający następujące informacje:

W wpisie: rozmiar buforu, do których odwołuje się pstrDirName.

Po powrocie: liczba znaków przechowywanych w parametrze pstrDirName. Jeśli funkcja składowa zakończy się niepowodzeniem i zostanie zwrócona ERROR_INSUFFICIENT_BUFFER, funkcja lpdwLen zawiera liczbę bajtów, które aplikacja musi przydzielić w celu odebrania ciągu.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

Aby uzyskać nazwę katalogu jako adres URL, wywołaj metodę GetCurrentDirectoryAsURL.

Parametry pstrDirName lub strDirName mogą być częściowo kwalifikowanymi nazwami plików względem bieżącego katalogu lub w pełni kwalifikowanymi. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. GetCurrentDirectory Tłumaczy separatory nazw katalogów na odpowiednie znaki przed ich zastosowaniem.

CFtpConnection::GetCurrentDirectoryAsURL

Wywołaj tę funkcję składową, aby uzyskać nazwę bieżącego katalogu jako adres URL.

BOOL GetCurrentDirectoryAsURL(CString& strDirName) const;

BOOL GetCurrentDirectoryAsURL(
    LPTSTR pstrName,
    LPDWORD lpdwLen) const;

Parametry

strDirName
Odwołanie do ciągu, który otrzyma nazwę katalogu.

pstrDirName
Wskaźnik do ciągu, który otrzyma nazwę katalogu.

lpdwLen
Wskaźnik do DWORD zawierający następujące informacje:

W wpisie: rozmiar buforu, do których odwołuje się pstrDirName.

Po powrocie: liczba znaków przechowywanych w parametrze pstrDirName. Jeśli funkcja składowa zakończy się niepowodzeniem i zostanie zwrócona ERROR_INSUFFICIENT_BUFFER, funkcja lpdwLen zawiera liczbę bajtów, które aplikacja musi przydzielić w celu odebrania ciągu.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

GetCurrentDirectoryAsURL zachowuje się tak samo jak GetCurrentDirectory

Parametr strDirName może być częściowo kwalifikowanymi nazwami plików względem bieżącego katalogu lub w pełni kwalifikowanymi. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. GetCurrentDirectoryAsURL Tłumaczy separatory nazw katalogów na odpowiednie znaki przed ich zastosowaniem.

CFtpConnection::GetFile

Wywołaj tę funkcję składową, aby pobrać plik z serwera FTP i zapisać go na komputerze lokalnym.

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

Parametry

pstrRemoteFile
Wskaźnik do ciągu zakończonego wartością null zawierającego nazwę pliku do pobrania z serwera FTP.

pstrLocalFile
Wskaźnik do ciągu zakończonego wartości null zawierającego nazwę pliku do utworzenia w systemie lokalnym.

bFailIfExists
Wskazuje, czy nazwa pliku może być już używana przez istniejący plik. Jeśli nazwa pliku lokalnego już istnieje, a ten parametr ma wartość TRUE, GetFile kończy się niepowodzeniem. GetFile W przeciwnym razie wymazze istniejącą kopię pliku.

dwAttributes
Wskazuje atrybuty pliku. Może to być dowolna kombinacja następujących flag FILE_ATTRIBUTE_*.

  • FILE_ATTRIBUTE_ARCHIVE Plik jest plikiem archiwum. Aplikacje używają tego atrybutu do oznaczania plików do tworzenia kopii zapasowej lub usuwania.

  • FILE_ATTRIBUTE_COMPRESSED Plik lub katalog jest skompresowany. W przypadku pliku kompresja oznacza, że wszystkie dane w pliku są kompresowane. W przypadku katalogu kompresja jest domyślna dla nowo utworzonych plików i podkatalogów.

  • FILE_ATTRIBUTE_DIRECTORY Plik jest katalogiem.

  • FILE_ATTRIBUTE_NORMAL Plik nie ma żadnych innych atrybutów ustawionych. Ten atrybut jest prawidłowy tylko wtedy, gdy jest używany sam. Wszystkie inne atrybuty pliku zastępują FILE_ATTRIBUTE_NORMAL:

  • FILE_ATTRIBUTE_HIDDEN Plik jest ukryty. Nie należy go dołączać do zwykłej listy katalogów.

  • FILE_ATTRIBUTE_READONLY Plik jest tylko do odczytu. Aplikacje mogą odczytywać plik, ale nie mogą go zapisywać ani usuwać.

  • FILE_ATTRIBUTE_SYSTEM Plik jest częścią lub jest używany wyłącznie przez system operacyjny.

  • FILE_ATTRIBUTE_TEMPORARY Plik jest używany do przechowywania tymczasowego. Aplikacje powinny zapisywać w pliku tylko wtedy, gdy jest to absolutnie konieczne. Większość danych pliku pozostaje w pamięci bez opróżniania do nośnika, ponieważ plik zostanie wkrótce usunięty.

dwFlags
Określa warunki, w których odbywa się transfer. Ten parametr może być dowolną wartością dwFlags opisaną w pliku FtpGetFile w zestawie WINDOWS SDK.

dwContext
Identyfikator kontekstu pobierania pliku. Zobacz Uwagi , aby uzyskać więcej informacji na temat dwContext.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

GetFile jest procedurą wysokiego poziomu, która obsługuje wszystkie obciążenia związane z odczytywaniem pliku z serwera FTP i przechowywaniem go lokalnie. Aplikacje, które pobierają tylko dane plików lub wymagają ścisłej kontroli nad transferem plików, powinny używać poleceń OpenFile i CInternetFile::Read .

Jeśli plik dwFlags jest FILE_TRANSFER_TYPE_ASCII, tłumaczenie danych plików konwertuje również znaki sterujące i formatowania na odpowiedniki systemu Windows. Domyślny transfer to tryb binarny, w którym plik jest pobierany w tym samym formacie, co jest przechowywany na serwerze.

Zarówno pstrRemoteFile , jak i pstrLocalFile mogą być częściowo kwalifikowanymi nazwami plików względem bieżącego katalogu lub w pełni kwalifikowanymi plikami. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. GetFile Tłumaczy separatory nazw katalogów na odpowiednie znaki przed ich zastosowaniem.

Zastąpij wartość domyślną dwContext , aby ustawić identyfikator kontekstu na wartość wybranej wartości. Identyfikator kontekstu jest skojarzony z tą konkretną operacją obiektu utworzonego CFtpConnection przez obiekt CInternetSession . Wartość jest zwracana do CInternetSession::OnStatusCallback , aby podać stan operacji, z którą została zidentyfikowana. Aby uzyskać więcej informacji na temat identyfikatora kontekstu, zobacz artykuł Internet First Steps: WinInet (Internet First Steps: WinInet: WinInet ).

CFtpConnection::OpenFile

Wywołaj tę funkcję składową, aby otworzyć plik znajdujący się na serwerze FTP na potrzeby odczytu lub zapisu.

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

Parametry

pstrFileName
Wskaźnik do ciągu zawierającego nazwę pliku do otwarcia.

dwAccess
Określa sposób uzyskiwania dostępu do pliku. Może to być GENERIC_READ lub GENERIC_WRITE, ale nie oba.

dwFlags
Określa warunki, w których występują kolejne transfery. Może to być dowolna z następujących FTP_TRANSFER_* stałych:

  • FTP_TRANSFER_TYPE_ASCII Transfery plików przy użyciu metody transferu FTP ASCII (Type A). Konwertuje informacje o kontrolce i formatowaniu na lokalne odpowiedniki.

  • FTP_TRANSFER_TYPE_BINARY Plik przesyła dane przy użyciu metody transferu obrazu (typu I) ftp. Plik przesyła dane dokładnie tak, jak istnieje, bez zmian. Jest to domyślna metoda transferu.

dwContext
Identyfikator kontekstu do otwierania pliku. Zobacz Uwagi , aby uzyskać więcej informacji na temat dwContext.

Wartość zwracana

Wskaźnik do obiektu CInternetFile .

Uwagi

OpenFile należy użyć w następujących sytuacjach:

  • Aplikacja zawiera dane, które należy wysłać i utworzyć jako plik na serwerze FTP, ale te dane nie są w pliku lokalnym. Po OpenFile otworzie pliku aplikacja używa pliku CInternetFile::Write do wysyłania danych pliku FTP na serwer.

  • Aplikacja musi pobrać plik z serwera i umieścić go w pamięci kontrolowanej przez aplikację, zamiast zapisywać go na dysku. Aplikacja używa pliku CInternetFile::Read po użyciu OpenFile polecenia , aby otworzyć plik.

  • Aplikacja potrzebuje dokładnego poziomu kontroli nad transferem plików. Na przykład aplikacja może chcieć wyświetlić kontrolkę postępu wskazującą postęp stanu transferu plików podczas pobierania pliku.

Po wywołaniu metody i do momentu wywołania OpenFile CInternetFile::Closemetody aplikacja może wywoływać tylko CInternetFile ::Read, CInternetFile::Write, CInternetConnection::Closelub CFtpFileFind::FindFile. Wywołania innych funkcji FTP dla tej samej sesji FTP zakończy się niepowodzeniem i ustawi kod błędu na FTP_ETRANSFER_IN_PROGRESS.

Parametr pstrFileName może być częściowo kwalifikowaną nazwą pliku względem bieżącego katalogu lub w pełni kwalifikowaną. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. OpenFile Tłumaczy separatory nazw katalogów na odpowiednie znaki przed jego użyciem.

Zastąpij wartość domyślną dwContext , aby ustawić identyfikator kontekstu na wartość wybranej wartości. Identyfikator kontekstu jest skojarzony z tą konkretną operacją obiektu utworzonego CFtpConnection przez obiekt CInternetSession . Wartość jest zwracana do CInternetSession::OnStatusCallback , aby podać stan operacji, z którą została zidentyfikowana. Aby uzyskać więcej informacji na temat identyfikatora kontekstu, zobacz artykuł Internet First Steps: WinInet (Internet First Steps: WinInet: WinInet ).

CFtpConnection::P utFile

Wywołaj tę funkcję składową, aby przechowywać plik na serwerze FTP.

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

Parametry

pstrLocalFile
Wskaźnik do ciągu zawierającego nazwę pliku do wysłania z systemu lokalnego.

pstrRemoteFile
Wskaźnik do ciągu zawierającego nazwę pliku do utworzenia na serwerze FTP.

dwFlags
Określa warunki, w których następuje transfer pliku. Może być dowolną z stałych FTP_TRANSFER_* opisanych w pliku OpenFile.

dwContext
Identyfikator kontekstu do umieszczenia pliku. Zobacz Uwagi , aby uzyskać więcej informacji na temat dwContext.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

PutFile jest procedurą wysokiego poziomu, która obsługuje wszystkie operacje skojarzone z przechowywaniem pliku na serwerze FTP. Aplikacje, które wysyłają tylko dane lub wymagają bliższej kontroli nad transferem plików, powinny używać plików OpenFile i CInternetFile::Write.

Zastąpij wartość domyślną dwContext , aby ustawić identyfikator kontekstu na wybraną wartość. Identyfikator kontekstu jest skojarzony z tą konkretną operacją obiektu utworzonego CFtpConnection przez obiekt CInternetSession . Wartość jest zwracana do CInternetSession::OnStatusCallback , aby podać stan operacji, z którą została zidentyfikowana. Aby uzyskać więcej informacji na temat identyfikatora kontekstu, zobacz artykuł Internet First Steps: WinInet (Internet First Steps: WinInet: WinInet ).

CFtpConnection::Remove

Wywołaj tę funkcję składową, aby usunąć określony plik z połączonego serwera.

BOOL Remove(LPCTSTR pstrFileName);

Parametry

pstrFileName
Wskaźnik do ciągu zawierającego nazwę pliku do usunięcia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

Parametr pstrFileName może być częściowo kwalifikowaną nazwą pliku względem bieżącego katalogu lub w pełni kwalifikowaną. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. Funkcja Remove tłumaczy separatory nazw katalogów na odpowiednie znaki przed ich zastosowaniem.

CFtpConnection::RemoveDirectory

Wywołaj tę funkcję składową, aby usunąć określony katalog z podłączonego serwera.

BOOL RemoveDirectory(LPCTSTR pstrDirName);

Parametry

pstrDirName
Wskaźnik do ciągu zawierającego katalog do usunięcia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

Użyj polecenia GetCurrentDirectory , aby określić bieżący katalog roboczy serwera. Nie zakładaj, że system zdalny połączył Cię z katalogem głównym.

Parametr pstrDirName może być częściowo lub w pełni kwalifikowaną nazwą pliku względem bieżącego katalogu. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. RemoveDirectory Tłumaczy separatory nazw katalogów na odpowiednie znaki przed ich zastosowaniem.

CFtpConnection::Rename

Wywołaj tę funkcję składową, aby zmienić nazwę określonego pliku na połączonym serwerze.

BOOL Rename(
    LPCTSTR pstrExisting,
    LPCTSTR pstrNew);

Parametry

pstrExisting
Wskaźnik do ciągu zawierającego bieżącą nazwę pliku do zmiany nazwy.

pstrNew
Wskaźnik do ciągu zawierającego nową nazwę pliku.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

Parametry pstrExisting i pstrNew mogą być częściowo kwalifikowaną nazwą pliku względem bieżącego katalogu lub w pełni kwalifikowaną. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. Rename Tłumaczy separatory nazw katalogów na odpowiednie znaki przed ich zastosowaniem.

CFtpConnection::SetCurrentDirectory

Wywołaj tę funkcję składową, aby zmienić katalog na inny katalog na serwerze FTP.

BOOL SetCurrentDirectory(LPCTSTR pstrDirName);

Parametry

pstrDirName
Wskaźnik do ciągu zawierającego nazwę katalogu.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0. Jeśli wywołanie zakończy się niepowodzeniem, funkcja Win32 GetLastError może zostać wywołana, aby określić przyczynę błędu.

Uwagi

Parametr pstrDirName może być częściowo lub w pełni kwalifikowaną nazwą pliku względem bieżącego katalogu. Ukośnik odwrotny (\) lub ukośnik ukośnik (/) może służyć jako separator katalogu dla nazwy. SetCurrentDirectory Tłumaczy separatory nazw katalogów na odpowiednie znaki przed ich zastosowaniem.

Użyj polecenia GetCurrentDirectory , aby określić bieżący katalog roboczy serwera FTP. Nie zakładaj, że system zdalny połączył Cię z katalogem głównym.

Zobacz też

Klasa CInternetConnection
Wykres hierarchii
Klasa CInternetConnection
Klasa CInternetSession