Udostępnij za pośrednictwem


Klasa CFtpConnection

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

Członkowie

Konstruktory publiczne

Nazwa/nazwisko opis
CFtp Połączenie ion::CFtp Połączenie ion CFtpConnection Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CFtp Połączenie ion::Command Wysyła polecenie bezpośrednio do serwera FTP.
CFtp Połączenie ion::CreateDirectory Tworzy katalog na serwerze.
CFtp Połączenie ion::GetCurrentDirectory Pobiera bieżący katalog dla tego połączenia.
CFtp Połączenie ion::GetCurrentDirectoryAsURL Pobiera bieżący katalog dla tego połączenia jako adres URL.
CFtp Połączenie ion::GetFile Pobiera plik z połączonego serwera
CFtp Połączenie ion::OpenFile Otwiera plik na połączonym serwerze.
CFtp Połączenie ion::P utFile Umieszcza plik na serwerze.
CFtp Połączenie ion::Remove Usuwa plik z serwera.
CFtp Połączenie ion::RemoveDirectory Usuwa określony katalog z serwera.
CFtp Połączenie ion::Rename Zmienia nazwę pliku na serwerze.
CFtp Połączenie ion::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ę CFtpConnectionCInternetSession::GetFtp Połączenie ion, 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 innymi dwoma obsługiwanymi usługami, HTTP i gopher, zobacz klasy CHttp Połączenie ion i CGopher Połączenie ion.

Przykład

Zobacz przykład w przeglądzie klasy CFtpFileFind .

Hierarchia dziedziczenia

Cobject

CInternet Połączenie ion

CFtpConnection

Wymagania

Nagłówek: afxinet.h

CFtp Połączenie ion::CFtp Połączenie ion

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 .

h Połączenie ed
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::GetFtp Połączenie ion, która tworzy CFptConnection obiekt.

CFtp Połączenie ion::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 CFtp Połączenie ion 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.

CFtp Połączenie ion::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.

CFtp Połączenie ion::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.

CFtp Połączenie ion::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.

CFtp Połączenie ion::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 ).

CFtp Połączenie ion::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 OpenFileCInternetFile::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 ).

CFtp Połączenie ion::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 ).

CFtp Połączenie ion::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.

CFtp Połączenie ion::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.

CFtp Połączenie ion::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.

CFtp Połączenie ion::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